メインコンテンツへスキップ
このページでは、Posts ルックアップエンドポイントをシステムに統合する際に役立つ各種ツールと重要な概念を紹介します。内容は次のセクションに整理されています。

​
便利なツール

いくつかの重要な概念に入る前に、次のツールに慣れておくことをおすすめします。 Postman
Postman は、提供されている内容を把握するために、あらゆるパスやボディパラメータを含むエンドポイントをテストするのに適したツールです。詳しくは、Postman のはじめ方ガイドをご覧ください。 コードサンプル
お好みのプログラミング言語向けのコードサンプルは、当社のGitHub ページでご確認いただけます。 サードパーティライブラリ
コミュニティによって作成された、v2 エンドポイントと互換性のあるサードパーティライブラリをご活用ください。

​
重要な基本概念

​
認証

すべての X API v2 エンドポイントでは、認証済みリクエストが必要です。次のいずれかの方法で認証できます:
OAuth 1.0a は実装が難しい場合があります。未経験の場合は、ライブラリや OAuth 2.0 の利用を検討してください。非公開メトリクスやPostには、OAuth 1.0a ユーザーコンテキストまたは OAuth 2.0 認可コード（PKCE 対応）を使用してください。
ご注意ください
次の fields をリクエストする場合は、OAuth 1.0a ユーザーコンテキストまたは OAuth 2.0 認可コードが必要です。
  • 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

​
開発者ポータル、プロジェクト、アプリ

X API v2の認証情報を取得するには、以下が必要です:
  1. 承認された開発者アカウント。
  2. 開発者アカウント内のプロジェクト。
  3. そのプロジェクト内の開発者アプリ。ここでキーとトークンを確認できます。

​
レート制限

X API へのリクエストは、ボリューム管理のためにレート制限の対象となります。制限はアプリおよびユーザーの両レベルで適用されます。
  • アプリレベル: 任意のアプリが一定期間内に行えるリクエスト数を制限します。
  • ユーザーレベル: 認証済みユーザーが開発者アプリ間でPostの検索（ルックアップ）を実行できる頻度を制限します。

​
fields と expansions

X API v2 では、fields と expansions を使って返却する特定の data フィールドを選択できます。
  • Expansions: 関連する追加オブジェクトを取得できます。サポートされている expansions には次が含まれます。
    • edit_history_tweet_ids
    • 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
  • Fields: オブジェクト内で返す data フィールドを指定します。Post オブジェクトのデフォルトは id、text、edit_history_tweet_ids です。tweet.created_at や tweet.entities などのその他のオプションは明示的に指定する必要があります。
詳細は、X API v2 data dictionary の fields と expansions のガイドを参照してください。

​
投稿の編集

対象の投稿は、公開から30分間に最大5回まで編集できます。Posts 参照エンドポイントは常に最新の投稿バージョンを返します。ほぼリアルタイムのユースケースでは、この時間枠に留意してください。詳細は投稿の編集の基本を参照してください。

​
例外ケース

  • プロモーション指標: プロモーションされていない Post に対してプロモーション指標をリクエストすると、空のレスポンスが返されます。
  • テキストの切り詰め: Retweet では Post のテキストが切り詰められます。全文を取得するには、参照されている Post を展開してください。