投稿を検索（直近）

​

recent Post counts エンドポイントのはじめ方

このクイックスタートガイドでは、HTTP リクエストを送信できるグラフィカルツールである Postman を使用して、recent Post counts エンドポイントへの最初のリクエストを行う方法を説明します。

さまざまなプログラミング言語のサンプルコードをご覧になりたい場合は、X API v2 sample code の GitHub リポジトリをご参照ください。

​

前提条件

このガイドを完了するには、リクエストを認証するための一連の keys and tokens が必要です。以下の手順に従って、これらの keys and tokens を生成できます。

• 開発者アカウントに登録し、承認を受ける。
• 開発者ポータルで Project と、それに関連付けられた developer App を作成する。
• アプリの「Keys and tokens」ページに移動して、必要なクレデンシャルを生成する。すべてのクレデンシャルは安全な場所に保存すること。

​

直近のPost件数リクエストを作成する手順

ステップ1：ツールまたはライブラリから始める

このエンドポイントにリクエストするために使用できるツール、コード例、ライブラリはいくつかありますが、ここでは手順を簡素化するためにPostmanを使用します。

X API v2 の Postman コレクションを環境に読み込むには、次のボタンをクリックしてください:

X API v2 を Postman に追加

Postman に X API v2 コレクションを読み込んだら、Post counts > Recent Post counts リクエストに移動します。

ステップ2：リクエストを認証する

X API に正しくリクエストするには、権限があることを確認する必要があります。このエンドポイントでは、OAuth 2.0 App-Only の認証方式でリクエストを認証する必要があります。

キーとトークン、特に App Access Token（App-only Bearer Token とも呼ばれます）を Postman に追加してください。Postman 右上の環境ドロップダウンで「X API v2」という名前の環境を選択し、「initial value」と「current value」フィールドにキーとトークンを追加します（環境ドロップダウン横の目のアイコンをクリック）。

正しく設定できていれば、この変数はリクエストの authorization タブに自動的に反映されます。  

ステップ3：クエリを作成する

各直近のPost件数リクエストには、1つのqueryが必要です。この例では、@XDevelopers アカウントが投稿したPostに一致するクエリを使用します。このクエリでは from: 演算子を使用し、XDevelopers（大文字・小文字は不問）を指定します：

from:XDevelopers

Postman で「Params」タブに移動し、このID、またはカンマ区切りのPost IDの文字列を ids パラメータの「Value」列に入力します。

Key	Value	Description
query	from:XDevelopers	直近のPost件数エンドポイントに送信するクエリ

ステップ4（任意）：リクエストの粒度を指定する

ステップ3の後に「Send」ボタンをクリックすると、デフォルトの直近のPost件数（過去7日間の1時間単位）が返されます。日単位で直近のPost件数を取得したい場合は、granularity パラメータに day を指定してください。

Postman で「Params」タブに移動し、granularity パラメータの「Value」列に day と入力します。

Key	Value	Description
granularity	day	Post件数結果の粒度。指定可能な値は day、hour、minute

「Send」ボタンの横に次のURLが表示されるはずです：

https://api.x.com/2/tweets/counts/recent?query=from%3AXDevelopers&granularity=day

ステップ5：リクエストを送信し、レスポンスを確認する

すべての設定が完了したら、「Send」ボタンをクリックすると次のレスポンスが返ってきます：

{
   "data": [
       {
           "end": "2021-06-16T00:00:00.000Z",
           "start": "2021-06-15T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-17T00:00:00.000Z",
           "start": "2021-06-16T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-06-18T00:00:00.000Z",
           "start": "2021-06-17T00:00:00.000Z",
           "tweet_count": 2
       },
       {
           "end": "2021-06-19T00:00:00.000Z",
           "start": "2021-06-18T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-20T00:00:00.000Z",
           "start": "2021-06-19T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-21T00:00:00.000Z",
           "start": "2021-06-20T00:00:00.000Z",
           "tweet_count": 0
       },
       {
           "end": "2021-06-22T00:00:00.000Z",
           "start": "2021-06-21T00:00:00.000Z",
           "tweet_count": 1
       },
       {
           "end": "2021-06-23T00:00:00.000Z",
           "start": "2021-06-22T00:00:00.000Z",
           "tweet_count": 2
       }
   ],
   "meta": {
       "total_tweet_count": 6
   }
}