役立つツール
このエンドポイントの統合に役立つ重要な概念に入る前に、以下について理解しておくことをお勧めします:Postman
Postman は、エンドポイントをテストするのに最適なツールです。各 Postman リクエストにはすべてのパスパラメーターとボディパラメーターが含まれており、利用可能なオプションを素早く把握するのに役立ちます。当社の Postman コレクションについて詳しくは、「Postman を使う」ページをご覧ください。コードサンプル
お好みのプログラミング言語でこのエンドポイントをセットアップしてみませんか?出発点として利用できるさまざまなコードサンプルを GitHub ページで公開しています。サードパーティ製ライブラリ
コミュニティによるサードパーティ製ライブラリを活用して開発を始められます。適切なバージョンタグを探すことで、v2 エンドポイントに対応したライブラリを見つけられます。重要な概念
認証
すべての X API v2 エンドポイントでは、キーとトークン(認証情報)を使ってリクエストを認証する必要があります。 Retweets ルックアップエンドポイントへのリクエスト認証には、OAuth 1.0a User Context または OAuth 2.0 Bearer Token のいずれかを使用できます。 manage Retweets エンドポイントには OAuth 1.0a User Context の使用が必要です。つまり、リクエストを成功させるには API キーとユーザーアクセストークンのセットを使用する必要があります。アクセストークンは、リクエストの代理として行うユーザーに関連付けられている必要があります。他のユーザーのアクセストークンを生成するには、そのユーザーが 3-legged OAuth フローを使用して App を承認または認証する必要があります。 OAuth 1.0a は扱いにくい場合がある点にご注意ください。この認証方式に不慣れな場合は、リクエストを適切に認証するためライブラリの使用をお勧めします。 注意 以下のフィールドをリクエストする場合、OAuth 1.0a User Context が必要です:- tweet.fields.non_public_metrics
- tweet.fields.promoted_metrics
- tweet.fields.organic_metrics
- media.fields.non_public_metrics
- media.fields.promoted_metrics
- media.fields.organic_metrics
Developer Console、Project、開発者 App
X API v2 エンドポイントで機能する認証情報を取得するには、開発者アカウントに登録し、そのアカウント内に Project を設定し、その Project 内に開発者 App を作成する必要があります。その後、開発者 App 内のキーとトークンを取得できます。レート制限
毎日、数千人の開発者が X API にリクエストを送信しています。膨大なリクエスト量を管理するため、各エンドポイントにはレート制限が設定されており、App または認証済みユーザーの代理として送信できるリクエスト数を制限しています。 manage Retweets エンドポイントは、ユーザーごとに 15 分あたり 50 リクエストに制限されています。さらに、POST エンドポイントは、ユーザーごとかつアプリごとに 3 時間ウィンドウあたり 300 リクエストに制限されています。 Retweets ルックアップエンドポイントは、15 分ウィンドウあたり 75 リクエストに制限されています。さらに、このエンドポイントは Retweet した最新の 100 ユーザーのみを返します。Fields と expansions
X API v2 では、fields と expansions というツールを使って、API から返すデータを正確に選択できます。expansion パラメーターを使うと、ペイロードで参照されるオブジェクトを展開できます。たとえば、このエンドポイントでは以下の expansions を取得できます:- attachments.poll_ids
- attachments.media_keys
- author_id, entities.mentions.username
- geo.place_id
- in_reply_to_user_id,
- referenced_tweets.id,
- referenced_tweets.id.author_id
コード例
投稿を Retweet したユーザーを取得する
cURL
投稿を Retweet する
cURL