X API の Rate Limits

Rate limits は各エンドポイントに対して行えるリクエスト数を制御します。上限を超えると、ウィンドウがリセットされるまで 429 エラーが返されます。

Rate limit の仕組み

Concept	Description
タイムウィンドウ	通常 15 分または 24 時間
Per-user limits	OAuth 1.0a または OAuth 2.0 user token で適用
Per-app limits	Bearer Token（app-only）で適用
Per-endpoint	各エンドポイントに独自の上限

上限の確認

レスポンスヘッダーで現在の rate limit ステータスを確認できます。

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

Rate limit 一覧

以下で各エンドポイントの rate limit を確認できます。これらの上限は Developer Console でも確認できます。

別途表記がない限り（例: “/24hrs” や “/sec”）、上限は 15 分あたりの値です。

Posts (25 エンドポイント)

Tweets lookup

Method	Endpoint	Per App	Per User
GET	`/2/tweets`	3,500/15min	5,000/15min
GET	`/2/tweets/:id`	450/15min	900/15min

Recent search

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

Full-archive search

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

Post counts

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

Filtered stream

Method	Endpoint	Per App	Per User	Notes
GET	`/2/tweets/search/stream`	50/15min	—	1 接続; 1000 ルール; ルール長 1024; 250 posts/sec
GET	`/2/tweets/search/stream/rules`	450/15min	—	1 接続; 1000 ルール; ルール長 1024
POST	`/2/tweets/search/stream/rules`	100/15min	—	1 接続; 1000 ルール; ルール長 1024

Manage posts

Method	Endpoint	Per App	Per User
POST	`/2/tweets`	10,000/24hrs	100/15min
DELETE	`/2/tweets/:id`	—	50/15min

Timelines

Method	Endpoint	Per App	Per User
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

Likes lookup

Method	Endpoint	Per App	Per User
GET	`/2/tweets/:id/liking_users`	75/15min	75/15min
GET	`/2/users/:id/liked_tweets`	75/15min	75/15min

Manage likes

Method	Endpoint	Per App	Per User
POST	`/2/users/:id/likes`	—	50/15min, 1,000/24hrs
DELETE	`/2/users/:id/likes/:tweet_id`	—	50/15min, 1,000/24hrs

Retweets lookup

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 結果

Manage retweets

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

Hide replies

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

Users (14 エンドポイント)

Users lookup

Method	Endpoint	Per App	Per User
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

Search users

Method	Endpoint	Per App	Per User
GET	`/2/users/search`	300/15min	900/15min

Follows lookup

Method	Endpoint	Per App	Per User
GET	`/2/users/:id/following`	300/15min	300/15min
GET	`/2/users/:id/followers`	300/15min	300/15min

Manage follows

Method	Endpoint	Per App	Per User
POST	`/2/users/:id/following`	—	50/15min
DELETE	`/2/users/:source_user_id/following/:target_user_id`	—	50/15min

Blocks lookup

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

Mutes lookup

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

Manage mutes

Method	Endpoint	Per App	Per User
POST	`/2/users/:id/muting`	—	50/15min
DELETE	`/2/users/:source_user_id/muting/:target_user_id`	—	50/15min

Spaces (6 エンドポイント)

Spaces lookup

Method	Endpoint	Per App	Per User
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

Search Spaces

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

Direct Messages (8 エンドポイント)

Direct Messages lookup

Method	Endpoint	Per App	Per User
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

Manage Direct Messages

Method	Endpoint	Per App	Per User
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

Lists (14 エンドポイント)

Lists lookup

Method	Endpoint	Per App	Per User
GET	`/2/lists/:id`	75/15min	75/15min
GET	`/2/users/:id/owned_lists`	15/15min	15/15min

List Tweets lookup

Method	Endpoint	Per App	Per User
GET	`/2/lists/:id/tweets`	900/15min	900/15min

List member lookup

Method	Endpoint	Per App	Per User
GET	`/2/lists/:id/members`	900/15min	900/15min
GET	`/2/users/:id/list_memberships`	75/15min	75/15min

Manage Lists

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

Manage List members

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

Manage List follows

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

Pinned Lists

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

Bookmarks (5 エンドポイント)

Bookmarks lookup

Method	Endpoint	Per App	Per User
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

Manage Bookmarks

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

Compliance (3 エンドポイント)

Batch compliance

Method	Endpoint	Per App	Per User
POST	`/2/compliance/jobs`	150/15min	—
GET	`/2/compliance/jobs/:job_id`	150/15min	—
GET	`/2/compliance/jobs`	150/15min	—

Usage (1 エンドポイント)

Method	Endpoint	Per App	Per User
GET	`/2/usage/tweets`	50/15min	—

Trends (2 エンドポイント)

Personalized Trends

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

Trends by WOEID

Method	Endpoint	Per App	Per User
GET	`/2/trends/by/woeid/:id`	75/15min	—

Communities (2 エンドポイント)

Method	Endpoint	Per App	Per User	Notes
GET	`/2/communities/:id`	300/15min	300/15min	—
GET	`/2/communities/search`	300/15min	300/15min	最大 100 結果

Analytics (1 エンドポイント)

Method	Endpoint	Per App	Per User
GET	`/2/tweets/analytics`	300/15min	300/15min

Media (8 エンドポイント)

Method	Endpoint	Per App	Per User
POST	`/2/media/upload`	50,000/24hrs	500/15min
GET	`/2/media/upload`	100,000/24hrs	1,000/15min
POST	`/2/media/upload/initialize`	180,000/24hrs	1,875/15min
POST	`/2/media/upload/:id/append`	180,000/24hrs	1,875/15min
POST	`/2/media/upload/:id/finalize`	180,000/24hrs	1,875/15min
POST	`/2/media/metadata`	50,000/24hrs	500/15min
POST	`/2/media/subtitles`	10,000/24hrs	100/15min
DELETE	`/2/media/subtitles`	10,000/24hrs	100/15min

Activity & Webhooks

Method	Endpoint	Per App	Per User	Notes
GET	`/2/activity/stream`	450/15min	—	2 接続; 250 posts/sec
POST	`/2/activity/subscriptions`	500/15min	—	—
GET	`/2/activity/subscriptions`	500/15min	—	—
PUT	`/2/activity/subscriptions/:subscription_id`	500/15min	—	—
DELETE	`/2/activity/subscriptions/:subscription_id`	500/15min	—	—
POST	`/2/webhooks`	450/15min	—	—
GET	`/2/webhooks`	450/15min	—	—
PUT	`/2/webhooks/:webhook_id`	450/15min	—	—
DELETE	`/2/webhooks/:webhook_id`	450/15min	—	—
POST	`/2/webhooks/replay`	100/15min	—	—

その他のエンドポイント

Method	Endpoint	Per App	Per User
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

Rate limit の処理

rate limit に達すると、429 レスポンスが返されます。

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

復旧戦略

x-rate-limit-reset でウィンドウがリセットされる時刻を確認
その時刻まで待機してから再試行
必要に応じて指数バックオフを使用

Example

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

ベストプラクティス

レスポンスをキャッシュ

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

ストリーミングを使用

リアルタイムデータには、ポーリングではなく filtered stream を使用してください。

ヘッダーを監視

上限に達しないよう残りリクエスト数を追跡してください。

リクエストを分散

リクエストをタイムウィンドウ全体に分散してください。

Rate limit と請求

Rate limit と請求は別物です。

Concept	Purpose
Rate limits	システム安定性のためリクエスト頻度を制御
Usage billing	取得したデータに対して課金（従量課金）

Rate limit の範囲内でも使用料が発生する場合があり、逆に追加コストなしで rate limit に達する場合もあります。

Enterprise の rate limits

Enterprise 顧客はカスタム rate limit を利用できます。アカウントマネージャーに連絡するか、Enterprise アクセスに申し込むください。

​Rate limit の仕組み

​上限の確認

​Rate limit 一覧

​Posts (25 エンドポイント)

​Tweets lookup

​Recent search

​Full-archive search

​Post counts

​Filtered stream

​Manage posts

​Timelines

​Likes lookup

​Manage likes

​Retweets lookup

​Manage retweets

​Hide replies

​Users (14 エンドポイント)

​Users lookup

​Search users

​Follows lookup

​Manage follows

​Blocks lookup

​Mutes lookup

​Manage mutes

​Spaces (6 エンドポイント)

​Spaces lookup

​Search Spaces

​Direct Messages (8 エンドポイント)

​Direct Messages lookup

​Manage Direct Messages

​Lists (14 エンドポイント)

​Lists lookup

​List Tweets lookup

​List member lookup

​Manage Lists

​Manage List members

​Manage List follows

​Pinned Lists

​Bookmarks (5 エンドポイント)

​Bookmarks lookup

​Manage Bookmarks

​Compliance (3 エンドポイント)

​Batch compliance

​Usage (1 エンドポイント)

​Trends (2 エンドポイント)

​Personalized Trends

​Trends by WOEID

​Communities (2 エンドポイント)

​Analytics (1 エンドポイント)

​Media (8 エンドポイント)

​Activity & Webhooks

​その他のエンドポイント

​Rate limit の処理

​復旧戦略

​ベストプラクティス

レスポンスをキャッシュ

ストリーミングを使用

ヘッダーを監視

リクエストを分散

​Rate limit と請求

​Enterprise の rate limits

​次のステップ

エラー処理

はじめに

Rate limit の仕組み

上限の確認

Rate limit 一覧

Posts (25 エンドポイント)

Tweets lookup

Recent search

Full-archive search

Post counts

Filtered stream

Manage posts

Timelines

Likes lookup

Manage likes

Retweets lookup

Manage retweets

Hide replies

Users (14 エンドポイント)

Users lookup

Search users

Follows lookup

Manage follows

Blocks lookup

Mutes lookup

Manage mutes

Spaces (6 エンドポイント)

Spaces lookup

Search Spaces

Direct Messages (8 エンドポイント)

Direct Messages lookup

Manage Direct Messages

Lists (14 エンドポイント)

Lists lookup

List Tweets lookup

List member lookup

Manage Lists

Manage List members

Manage List follows

Pinned Lists

Bookmarks (5 エンドポイント)

Bookmarks lookup

Manage Bookmarks

Compliance (3 エンドポイント)

Batch compliance

Usage (1 エンドポイント)

Trends (2 エンドポイント)

Personalized Trends

Trends by WOEID

Communities (2 エンドポイント)

Analytics (1 エンドポイント)

Media (8 エンドポイント)

Activity & Webhooks

その他のエンドポイント

Rate limit の処理

復旧戦略

ベストプラクティス

Rate limit と請求

Enterprise の rate limits

次のステップ