メインコンテンツへスキップ
このページでは、Posts のルックアップ endpoint をシステムに統合する際に役立つ複数のツールと主要な概念を紹介します。ページは次のセクションに整理されています:

​
役立つツール

いくつかの重要な概念に入る前に、次のツールに慣れておくことをおすすめします。 Postman
Postman は、利用可能な項目を把握するために、すべてのパスやボディパラメータを含む endpoint をテストするのに最適なツールです。詳しくは、Postman のはじめ方ガイドをご覧ください。 コードサンプル
お好みのプログラミング言語向けのコードサンプルは、GitHub ページでご覧いただけます。 サードパーティ製ライブラリ
コミュニティが作成した、v2 endpoint と互換性のあるサードパーティ製ライブラリを活用してください。

​
重要な概念

​
認証

すべての X API v2 endpoint には認証済みリクエストが必要です。次のいずれかで認証できます。
OAuth 1.0a は実装が難しい場合があります。馴染みがない場合は、ライブラリの利用や OAuth 2.0 の使用を検討してください。非公開の metrics や Posts にアクセスするには、OAuth 1.0a ユーザーコンテキストまたは OAuth 2.0 Authorization Code（PKCE 付き）を使用してください。
ご注意ください
次の fields をリクエストする場合、OAuth 1.0a ユーザーコンテキストまたは OAuth 2.0 Authorization Code が必要です。
  • 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 portal、Project、App

X API v2 の認証情報を取得するには、次が必要です。
  1. 承認済みのデベロッパーアカウント。
  2. デベロッパーアカウント内のProject。
  3. その Project 内の開発者用 App。ここでキーおよびトークンを確認できます。

​
レートリミット

X API のリクエストは、リクエスト量を管理するためにレートリミットの対象となります。リミットは App レベルとユーザーレベルの両方に適用されます：
  • App レベル: いずれの App でも、一定期間内に行えるリクエスト数を制限します。
  • ユーザーレベル: 認証済みユーザーが開発者用 App をまたいで Post のルックアップを行える頻度を制限します。

​
フィールドと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 データディクショナリの「fields と expansions」ガイドを参照してください。

​
Post の編集

対象の Posts は、公開後30分以内で最大5回まで編集できます。Posts ルックアップ endpoint は常に最新の Post バージョンを返します。ほぼリアルタイムのユースケースでは、この時間枠を考慮してください。詳細は、Edit Posts の基本を参照してください。

​
例外的なケース

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