レート制限

X の開発者向けプロダクト全体における API レート制限について理解する

レート制限は、一定期間内に実行できる 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

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 のレート制限ページを参照してください。

• X API v2 のレート制限
• X Ads API のレート制限