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

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

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

X API v2

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

Enterprise API

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

X Ads API

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

​
レート制限の仕組み

概念説明
時間枠ほとんどのレート制限は 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
HeaderDescription
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 のレート制限ページを参照してください。