> ## Documentation Index
> Fetch the complete documentation index at: https://x-preview-mintlify-e187ed14.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# レート制限

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

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

***

## 製品別のレート制限

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

<CardGroup cols={3}>
  <Card title="X API v2" icon="square-x-twitter" href="/x-api/fundamentals/rate-limits">
    15 分間のウィンドウに基づくエンドポイント単位の制限。詳細な表と回復のヒントを表示します。
  </Card>

  <Card title="Enterprise API" icon="building" href="/x-api/enterprise-gnip-2.0/fundamentals/rate-limits">
    エンタープライズ契約とデータパッケージに基づくカスタム制限。
  </Card>

  <Card title="X Ads API" icon="rectangle-ad" href="/x-ads-api/fundamentals/rate-limiting">
    広告管理とアナリティクスエンドポイント固有の制限。
  </Card>
</CardGroup>

***

## レート制限の仕組み

| 概念            | 説明                                          |
| :------------ | :------------------------------------------ |
| **時間枠**       | ほとんどの制限は 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** レスポンスを受信します:

```json theme={null}
{
  "errors": [{
    "code": 88,
    "message": "Rate limit exceeded"
  }]
}
```

***

## ベストプラクティス

<CardGroup cols={2}>
  <Card title="レスポンスをキャッシュ" icon="database">
    同じデータへの繰り返しリクエストを減らすために、API レスポンスをローカルに保存します。
  </Card>

  <Card title="指数バックオフを使用" icon="clock-rotate-left">
    レート制限を受けた場合、再試行前に待機します。再試行ごとに待機時間を倍にします。
  </Card>

  <Card title="ヘッダーを確認" icon="list-check">
    制限に達するのを事前に避けるために、レート制限ヘッダーをモニタリングします。
  </Card>

  <Card title="ストリーミングを使用" icon="signal-stream">
    リアルタイムデータには、検索エンドポイントをポーリングする代わりに Filtered stream を使用します。
  </Card>
</CardGroup>

***

## 次のステップ

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

* [X API v2 のレート制限](/x-api/fundamentals/rate-limits)
* [X Ads API のレート制限](/x-ads-api/fundamentals/rate-limiting)