X API レート制限

X API v2 のエンドポイントごとのレート制限

レート制限は、各エンドポイントごとに実行できるリクエスト数を制御します。制限を超過すると、ウィンドウがリセットされるまで 429 エラーが返されます。

---

レート制限の仕組み

概念	説明
時間ウィンドウ	通常は 15 分または 24 時間です
ユーザー単位の制限	OAuth 1.0a または OAuth 2.0 のユーザートークンを使用する場合に適用されます
App 単位の制限	ベアラートークン (App 専用) を使用する場合に適用されます
エンドポイント単位	各エンドポイントごとに固有の制限があります

---

制限の確認

レスポンスヘッダーには、現在のレート制限の状態が示されます。

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 タイムスタンプ

---

レート制限テーブル

各エンドポイントのレート制限は以下のテーブルで確認できます。開発者コンソールでも同じ制限を確認できます。

特に記載がない限り、制限は 15 分ごとの上限として表示されています (例: 「/24hrs」や「/sec」) 。

投稿 (25個のエンドポイント)

ツイートの取得

Method	Endpoint	App ごと	ユーザーごと
GET	/2/tweets	3,500/15min	5,000/15min
GET	/2/tweets/:id	450/15min	900/15min

直近の検索

Method	Endpoint	Per App	Per User	Notes
GET	/2/tweets/search/recent	450/15min	300/15min	デフォルトは 10 件、最大 100 件の結果; クエリ長は最大 512 文字

全アーカイブ検索

Method	Endpoint	Per App	Per User	Notes
GET	/2/tweets/search/all	1/sec, 300/15min	1/sec	デフォルト 10 件、最大 500 件の結果; クエリ長 1024 文字

ポスト数

Method	Endpoint	Per App	Per User	注記
GET	/2/tweets/counts/recent	300/15min	—	クエリ長: 512
GET	/2/tweets/counts/all	300/15min	—	クエリ長: 1024

フィルタ済みストリーム

Method	Endpoint	App ごと	ユーザーごと	注記
GET	/2/tweets/search/stream	50/15min	—	接続数 1; ルール数 1000; ルール長 1024; 250 投稿/秒
GET	/2/tweets/search/stream/rules	450/15min	—	接続数 1; ルール数 1000; ルール長 1024
POST	/2/tweets/search/stream/rules	100/15min	—	接続数 1; ルール数 1000; ルール長 1024

投稿の管理

Method	Endpoint	App ごと	ユーザーごと
POST	/2/tweets	10,000/24hrs	100/15min
DELETE	/2/tweets/:id	—	50/15min

タイムライン

Method	Endpoint	App ごと	ユーザーごと
GET	/2/users/:id/tweets	10,000/15min	900/15min
GET	/2/users/:id/mentions	450/15min	300/15min
GET	/2/users/:id/timelines/reverse_chronological	—	180/15min

いいねの取得

Method	Endpoint	App ごと	ユーザーごと
GET	/2/tweets/:id/liking_users	75/15min	75/15min
GET	/2/users/:id/liked_tweets	75/15min	75/15min

いいね管理

メソッド	エンドポイント	App 単位	ユーザー単位
POST	/2/users/:id/likes	—	50/15分, 1,000/24時間
DELETE	/2/users/:id/likes/:tweet_id	—	50/15分, 1,000/24時間

リツイートの取得

Method	Endpoint	Per App	Per User	Notes
GET	/2/tweets/:id/retweeted_by	75/15min	75/15min	—
GET	/2/tweets/:id/quote_tweets	75/15min	75/15min	—
GET	/2/users/reposts_of_me	—	75/15min	最大 100 件の結果

リツイートの管理

メソッド	エンドポイント	アプリごと	ユーザーごと
POST	/2/users/:id/retweets	—	50/15min
DELETE	/2/users/:id/retweets/:tweet_id	—	50/15min

返信を非表示にする

Method	Endpoint	Per App	Per User
PUT	/2/tweets/:tweet_id/hidden	—	50/15min

---

ユーザー (14個のエンドポイント)

ユーザー取得

Method	Endpoint	App ごと	ユーザーごと
GET	/2/users	300/15min	900/15min
GET	/2/users/:id	300/15min	900/15min
GET	/2/users/by	300/15min	900/15min
GET	/2/users/by/username/:username	300/15min	900/15min
GET	/2/users/me	—	75/15min

ユーザー検索

Method	Endpoint	App ごと	ユーザーごと
GET	/2/users/search	300/15min	900/15min

フォロー取得

Method	Endpoint	App ごと	ユーザーごと
GET	/2/users/:id/following	300/15min	300/15min
GET	/2/users/:id/followers	300/15min	300/15min

フォローの管理

メソッド	エンドポイント	App ごと	ユーザーごと
POST	/2/users/:id/following	—	50/15min
DELETE	/2/users/:source_user_id/following/:target_user_id	—	50/15min

ブロックの取得

Method	Endpoint	App ごと	ユーザーごと
GET	/2/users/:id/blocking	—	15/15min

ミュートの取得

Method	Endpoint	Per App	Per User
GET	/2/users/:id/muting	—	15/15min

ミュートの管理

Method	Endpoint	App 単位	ユーザー単位
POST	/2/users/:id/muting	—	50/15min
DELETE	/2/users/:source_user_id/muting/:target_user_id	—	50/15min

---

Spaces (6 個のエンドポイント)

Spaces 取得

Method	Endpoint	アプリごと	ユーザーごと
GET	/2/spaces/:id	300/15min	300/15min
GET	/2/spaces	300/15min	300/15min
GET	/2/spaces/:id/tweets	300/15min	300/15min
GET	/2/spaces/by/creator_ids	300/15min, 1/sec	300/15min, 1/sec
GET	/2/spaces/:id/buyers	300/15min	300/15min

Spaces の検索

Method	Endpoint	Per App	Per User
GET	/2/spaces/search	300/15分	300/15分

---

ダイレクトメッセージ (8個のエンドポイント)

ダイレクトメッセージの取得

Method	Endpoint	App ごと	ユーザーごと
GET	/2/dm_events	—	15/15min
GET	/2/dm_events/:id	—	15/15min
GET	/2/dm_conversations/:dm_conversation_id/dm_events	—	15/15min
GET	/2/dm_conversations/with/:participant_id/dm_events	—	15/15min

ダイレクトメッセージの管理

Method	Endpoint	アプリごと	ユーザーごと
POST	/2/dm_conversations	1,440/24hrs	15/15min, 1,440/24hrs
POST	/2/dm_conversations/with/:participant_id/messages	1,440/24hrs	15/15min, 1,440/24hrs
POST	/2/dm_conversations/:dm_conversation_id/messages	1,440/24hrs	15/15min, 1,440/24hrs
DELETE	/2/dm_events/:id	4,000/24hrs	300/15min, 1,500/24hrs

---

リスト (14 個のエンドポイント)

リストの取得

Method	Endpoint	App ごと	ユーザーごと
GET	/2/lists/:id	75/15min	75/15min
GET	/2/users/:id/owned_lists	15/15min	15/15min

リスト内ツイートの取得

メソッド	エンドポイント	App ごと	ユーザーごと
GET	/2/lists/:id/tweets	900/15min	900/15min

リストメンバーの参照

メソッド	エンドポイント	App ごと	ユーザーごと
GET	/2/lists/:id/members	900/15min	900/15min
GET	/2/users/:id/list_memberships	75/15min	75/15min

リストの管理

Method	Endpoint	Per App	Per User
POST	/2/lists	—	300/15min
DELETE	/2/lists/:id	—	300/15min
PUT	/2/lists/:id	—	300/15min

リストのメンバーを管理

Method	Endpoint	Per App	Per User
POST	/2/lists/:id/members	—	300/15min
DELETE	/2/lists/:id/members/:user_id	—	300/15min

リストフォローの管理

Method	Endpoint	App ごと	ユーザーごと
POST	/2/users/:id/followed_lists	—	50/15min
DELETE	/2/users/:id/followed_lists/:list_id	—	50/15min

ピン留めされたリスト

Method	Endpoint	Per App	Per User
GET	/2/users/:id/pinned_lists	15/15min	15/15min
POST	/2/users/:id/pinned_lists	—	50/15min
DELETE	/2/users/:id/pinned_lists/:list_id	—	50/15min

---

ブックマーク (5個のエンドポイント)

ブックマークの取得

メソッド	エンドポイント	App ごと	ユーザーごと
GET	/2/users/:id/bookmarks	—	180/15min
GET	/2/users/:id/bookmarks/folders	50/15min	50/15min
GET	/2/users/:id/bookmarks/folders/:folder_id	50/15min	50/15min

ブックマークの管理

Method	Endpoint	Per App	Per User
POST	/2/users/:id/bookmarks	—	50/15min
DELETE	/2/users/:id/bookmarks/:tweet_id	—	50/15min

---

コンプライアンス (3 個のエンドポイント)

バッチコンプライアンス

メソッド	エンドポイント	App ごと	ユーザーごと
POST	/2/compliance/jobs	150/15min	—
GET	/2/compliance/jobs/:job_id	150/15min	—
GET	/2/compliance/jobs	150/15min	—

---

使用量 (1 エンドポイント)

メソッド	エンドポイント	App ごと	ユーザーごと
GET	/2/usage/tweets	50/15分	—

---

トレンド (2件のエンドポイント)

パーソナライズドトレンド

Method	Endpoint	Per App	Per User
GET	/2/users/personalized_trends	200/24hrs, 200/15min	100/24hrs, 10/15min

WOEID ごとのトレンド

Method	Endpoint	App ごと	ユーザーごと
GET	/2/trends/by/woeid/:id	75/15min	—

---

Communities (2 エンドポイント)

Method	Endpoint	App ごと	ユーザーごと	注記
GET	/2/communities/:id	300/15min	300/15min	—
GET	/2/communities/search	300/15min	300/15min	最大 100 件の結果

---

アナリティクス (1 個のエンドポイント)

Method	Endpoint	App ごと	ユーザーごと
GET	/2/tweets/analytics	300/15min	300/15min

---

メディア (8 エンドポイント)

メソッド	エンドポイント	App ごと	ユーザーごと
POST	/2/media/upload	50,000/24時間	500/15分
GET	/2/media/upload	100,000/24時間	1,000/15分
POST	/2/media/upload/initialize	180,000/24時間	1,875/15分
POST	/2/media/upload/:id/append	180,000/24時間	1,875/15分
POST	/2/media/upload/:id/finalize	180,000/24時間	1,875/15分
POST	/2/media/metadata	50,000/24時間	500/15分
POST	/2/media/subtitles	10,000/24時間	100/15分
DELETE	/2/media/subtitles	10,000/24時間	100/15分

---

アクティビティと Webhook

Method	Endpoint	App ごと	ユーザーごと	備考
GET	/2/activity/stream	450/15分	—	同時接続2件、1秒あたり250投稿
POST	/2/activity/subscriptions	500/15分	—	—
GET	/2/activity/subscriptions	500/15分	—	—
PUT	/2/activity/subscriptions/:subscription_id	500/15分	—	—
DELETE	/2/activity/subscriptions/:subscription_id	500/15分	—	—
POST	/2/webhooks	450/15分	—	—
GET	/2/webhooks	450/15分	—	—
PUT	/2/webhooks/:webhook_id	450/15分	—	—
DELETE	/2/webhooks/:webhook_id	450/15分	—	—
POST	/2/webhooks/replay	100/15分	—	—

---

その他のエンドポイント

Method	Endpoint	Appごと	ユーザーごと
GET	/2/tweets/sample10/stream	100/15min	—
GET	/2/news/:id	200/15min	—
GET	/2/news/search	200/15min	200/15min
POST	/2/users/:id/dm/block	25/15min, 1,000/24hrs	10/15min, 400/24hrs
POST	/2/users/:id/dm/unblock	25/15min, 1,000/24hrs	10/15min, 400/24hrs
GET	/2/users/by/username/:username/tweets	1,500/15min	900/15min
GET	/2/users/by/username/:username/mentions	450/15min	180/15min
GET	/2/users/:id/following/spaces	300/15min	300/15min
GET	/2/tweets/:id/retweets	75/15min	75/15min
DELETE	/2/connections/all	25/15min	25/15min

---

レート制限への対処

レート制限に達すると、HTTP 429 レスポンスが返されます。

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

リカバリー戦略

1. x-rate-limit-reset ヘッダーでウィンドウのリセット時刻を確認する
2. 再試行する前にその時刻まで待機する
3. 必要に応じて指数バックオフを使用する

import time

def make_request_with_backoff(url, headers):
    response = requests.get(url, headers=headers)
    
    if response.status_code == 429:
        reset_time = int(response.headers.get('x-rate-limit-reset', 0))
        wait_time = max(reset_time - time.time(), 60)
        time.sleep(wait_time)
        return make_request_with_backoff(url, headers)
    
    return response

---

ベストプラクティス

レスポンスをキャッシュする

結果をローカルに保存して、同じリクエストの繰り返しを減らします。

ストリーミングを利用する

リアルタイムデータには、ポーリングではなくフィルタ済みストリームを使用します。

ヘッダーを監視する

残りリクエスト数を追跡し、レート制限に達するのを避けます。

リクエストを分散する

リクエストを時間ウィンドウ全体に分散させます。

---

レート制限と課金

レート制限と課金は別に管理されています。

概念	目的
レート制限	システムの安定性を保つためにリクエスト頻度を制御する
利用課金	取得したデータ量に応じて課金する (従量課金)

レート制限内に収まっていても利用料金が発生しますし、追加の料金なしでレート制限に達することもあります。

---

エンタープライズ向けのレート制限

エンタープライズのお客様には、カスタムのレート制限が設定されています。アカウントマネージャーに連絡するか、Enterprise へのアクセスを申請してください。

---

次のステップ

エラー処理

429 などのエラーを処理します。

はじめに

アクセスレベルと機能について学びます。