レート制限

アクセスティアおよびエンドポイントごとの X API レート制限について、アプリレベル vs ユーザーレベルの制限、レスポンスヘッダー、再試行のベストプラクティスを含めて理解します。

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

---

製品別のレート制限

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

X API v2

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

Enterprise API

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

X Ads API

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

---

レート制限の仕組み

概念	説明
時間枠	ほとんどの制限は 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

ヘッダー	説明
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 レスポンスをローカルに保存します。

指数バックオフを使用

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

ヘッダーを確認

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

ストリーミングを使用

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

---

次のステップ

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

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