レート制限 - X

レート制限は、特定の時間枠内に行える API リクエスト数を制御します。プラットフォーム全体での公正な使用とシステムの安定性を保証します。

製品別のレート制限

各 X API 製品には独自のレート制限アプローチがあります:

15 分間のウィンドウに基づくエンドポイント単位の制限。詳細な表と回復のヒントを表示します。

エンタープライズ契約とデータパッケージに基づくカスタム制限。

広告管理とアナリティクスエンドポイント固有の制限。

概念	説明
時間枠	ほとんどの制限は 15 分ごとにリセットされます
ユーザーごとの制限	OAuth 1.0a または OAuth 2.0 ユーザートークンを使用する場合に適用
アプリごとの制限	Bearer Token (アプリのみ) 認証を使用する場合に適用
エンドポイント固有	各エンドポイントには独自の制限があります

すべての API レスポンスには現在のレート制限ステータスを示すヘッダーが含まれます:

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

レート制限を超えると、429 Too Many Requests レスポンスを受信します:

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

同じデータへの繰り返しリクエストを減らすために、API レスポンスをローカルに保存します。

レート制限を受けた場合、再試行前に待機します。再試行ごとに待機時間を倍にします。

制限に達するのを事前に避けるために、レート制限ヘッダーをモニタリングします。

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

エンドポイント別の詳細なレート制限表については、特定の API のレート制限ページを参照してください: