レート制限

レート制限は、一定期間内に実行できる API リクエスト数を制御します。これにより、プラットフォーム全体での公平な利用とシステムの安定性が保たれます。

プロダクトごとのレート制限

各 X API プロダクトには、それぞれ独自のレート制限ポリシーがあります。

15 分ごとの時間枠に基づくエンドポイント単位の制限。詳細な一覧表や復旧のためのヒントを確認できます。

お客様のエンタープライズ契約およびデータパッケージに基づくカスタム制限。

広告管理およびアナリティクス関連エンドポイントに固有の制限。

概念	説明
時間枠	ほとんどのレート制限は 15 分ごとにリセットされます
ユーザー単位の制限	OAuth 1.0a または OAuth 2.0 のユーザートークンを使用する場合に適用されます
アプリ単位の制限	ベアラートークン (app-only) 認証を使用する場合に適用されます
エンドポイントごとの制限	各エンドポイントごとに個別の制限があります

すべての API レスポンスには、現在のレート制限状況を示すヘッダーが含まれています。

x-rate-limit-limit: 900
x-rate-limit-remaining: 847
x-rate-limit-reset: 1705420800

Header	Description
`x-rate-limit-limit`	現在のウィンドウ内で許可されている最大リクエスト数
`x-rate-limit-remaining`	現在のウィンドウ内での残りリクエスト数
`x-rate-limit-reset`	制限がリセットされる Unix タイムスタンプ

レート制限を超過すると、429 Too Many Requests レスポンスが返されます。

{
  "errors": [{
    "code": 88,
    "message": "Rate limit exceeded"
  }]
}

同じデータに対する重複リクエストを減らすため、API レスポンスをローカルに保存します。

レート制限が発生した場合は、リトライする前に待機し、リトライのたびに待機時間を 2 倍にします。

レート制限に達することを防ぐため、レート制限ヘッダーを継続的に監視します。

リアルタイムデータには、検索エンドポイントをポーリングする代わりに filtered stream を使用します。

エンドポイントごとの詳細なレート制限一覧は、お使いの各 API のレート制限ページを参照してください。