メインコンテンツへスキップ
v2 の Post カウントエンドポイントは、指定したクエリに対するデータ量を把握・取得するためのものです。これは、次のようなさまざまな理由で有益です:
  • トレンドラインなどの可視化を作成するために、キーワードの Post ボリュームを把握する。
  • イベントや会話が発生した期間を把握し、クエリで関連するデータを確実に取得できるようにする。
  • 最近の検索や全アーカイブ検索のエンドポイントを使用する前に、クエリを洗練させる目的で、その検索クエリが返す Post 数を把握する。 ご注意: 検索エンドポイントはカウントエンドポイントにはない追加のコンプライアンス処理を経るため、カウントが検索エンドポイントの結果と常に一致するわけではありません
  • 実際に生データを取得せずにトピック周辺の会話規模を把握し、月間のPost 上限に対する Post を管理する。
クエリを作成する際は、access levelに基づき、クエリ長や使用可能なオペレーターが制限されます。
  • プロのアクセスを持つ Project を使用している場合、利用可能なすべてのオペレーターを使用でき、クエリ長は最大 1024 文字まで使用できます。
  • エンタープライズのアクセスを持つ Project を使用している場合、利用可能なすべてのオペレーターを使用でき、クエリ長は最大 4096 文字まで使用できます。
粒度（day、hour、minute のいずれか）および Post カウントが必要な期間（パラメータ start_time と end_time を使用）も指定できます。このエンドポイントのデフォルトの時間粒度は hour であり、granularity パラメータを指定しない場合、直近 7 日間について 1 時間ごとの Post カウントが返されます。
アカウント設定これらのエンドポイントにアクセスするには、次が必要です:X API v2 エンドポイントへのアクセス取得については、はじめにガイドをご覧ください。

​
Recent Post counts

直近のPost件数エンドポイントでは、過去7日間にわたり、指定したクエリに一致するPostの件数をプログラムで取得できます。このエンドポイントは、App に関連付けられたキーとトークンを使用しているすべてのユーザーが Project 内で利用でき、認証には OAuth 2.0 App-Only を使用します。

​
フルアーカイブのPost件数

フルアーカイブのPost件数エンドポイントを使用すると、公開Postの全アーカイブを対象に、指定したクエリに一致するPostの件数をプログラムで取得できます。現在、このエンドポイントは、Academic Research または Enterprise アクセスの承認を受け、認証に OAuth 2.0 App-Only を使用している方のみが利用できます。 例: フルアーカイブのPost件数エンドポイントを使って、2017年8月から9月の間に、ハッシュタグ #SOSHurricaneHarvey の1日あたりのPost件数を確認できます。 注意: counts エンドポイントは、1レスポンスあたり31日分でページネーションされます。たとえば、granularity を day に設定すると、1ページあたり31日分の各日の件数が返されます。granularity を hour に設定すると、1ページあたり744時間分（31日 × 24時間）の各時間の件数が返されます。granularity と期間を指定しない場合、このエンドポイントは直近30日間について、クエリに対する1時間ごとのPost件数を返します。