Skip to main content
このページでは、Post counts エンドポイントを統合するためのツールと重要な概念を扱います。

​
役立つツール

主要な概念に入る前に、これらのエンドポイントの機能をテストできる次のツールやコードサンプルの利用をお勧めします。

​
コードサンプル

お好みのプログラミング言語でこれらのエンドポイントをセットアップしてみませんか?GitHub ページには、出発点として利用できるさまざまなコードサンプル(Python クライアントを含む)を公開しています。

​
ライブラリ

コミュニティによる多数のサードパーティ製ライブラリを活用して開発を始められます。適切なバージョンタグを探すことで、v2 エンドポイントに対応したライブラリを見つけられます。

​
Postman

Postman はこれらのエンドポイントをテストするのに最適なツールです。各 Postman リクエストにはエンドポイントのすべてのパラメーターが含まれており、利用可能なオプションを素早く把握するのに役立ちます。当社の Postman コレクションについて詳しくは、Postman を使うページをご覧ください。

​
重要な概念

​
認証

すべての X API v2 エンドポイントは、キーとトークン(認証情報)のセットで認証されたリクエストを必要とします。このエンドポイントでは OAuth 2.0 Bearer Token の使用が必須です。つまり、リクエストを成功させるには Bearer Token を渡す必要があります。Bearer Token は開発者 App から直接生成することも、POST oauth2/token エンドポイントを用いて生成することもできます。

​
Developer Console、Project、開発者 App

X API v2 エンドポイントを利用するには、開発者アカウントを所有し、そのアカウント内に Project を設定し、その Project 内に開発者 App を作成する必要があります。その開発者 App のキーとトークンは recent Post counts エンドポイントで利用できます。full-archive Post counts エンドポイントを利用したい場合や、advanced 演算子・より長いクエリ長を使いたい場合は、Enterprise アクセスの承認を受ける必要があります。 詳細は Enterprise アクセスに関するセクションをご覧ください。

​
レート制限

毎日、数千人の開発者が X API にリクエストを送信しています。そのボリュームを管理するため、各エンドポイントにはレート制限が設定されており、App または認証済みユーザーの代理として送信できるリクエスト数が制限されています。 このエンドポイントは App レベルでレート制限されます。つまり、開発者は特定の App(使用中の認証情報から特定される)を通じて、一定期間内にこのエンドポイントへ送信できるリクエスト数に制限があります。

​
クエリの構築

これらのエンドポイントの中核的な特徴は、単一のクエリを使用して投稿をフィルタリングし、件数として返す点です。クエリは、メッセージのキーワード、ハッシュタグ、URL など、投稿とユーザーの属性に一致する演算子で構成されます。演算子はブールロジックと括弧で組み合わせて、クエリの一致挙動をより詳細に調整できます。 詳細はクエリを組み立てる方法のガイドをご覧ください。

​
ページネーション

recent Post counts では next_token は返されません。つまり、granularity にかかわらず、直近 7 日間の投稿ボリュームを 1 回の API 呼び出しで取得できます。 full-archive Post counts では、直近 30 日間のデータが取得できます。30 日を超えるデータを取得するには next_token が返され、それを使ってページネーションを行い追加のデータを取得できます。