レート制限
レート制限の仕組み
レート制限はアカウント単位で、1 秒あたりのリクエスト数 (QPS) で測定します。上限はクレジット購入履歴の有無で決まり、上位 2 プランでは少しだけ引き上げられます。
月間の上限も日次の上限もありません。1 秒あたりの上限を超えなければ、1 か月に何クレジットでも消費できます。
ストリーム (アカウント監視) サブスクリプションは REST API とは別枠です。 ストリームプランには API クレジットも、より高い REST レート制限も含まれません。REST 呼び出しはクレジットで支払い、クレジットを購入するまでアカウントは無料枠の 5 秒に 1 リクエストのまま据え置きです。
具体的な上限
| アカウント状態 | レート制限 |
|---|---|
新規アカウント (未課金) 0.2 req/s — API を試すには十分で、初回チャージを後押しします。 | 5 秒に 1 リクエスト |
一度でもクレジットを購入したことのあるアカウント 一度クレジットを購入すれば十分で、サブスクリプションは不要です。 | 20 req/s |
Starter・Builder・Pro サブスクリプション これらのプランはクレジット量、ボーナス率、クレジット返還で差別化され、スループットでは差がつきません。より高い持続 QPS が必要なら、下記の Scale と Business をご覧ください。 | 20 req/s |
Scale サブスクリプション | 50 req/s |
Business サブスクリプション | 500 req/s |
さらに大きなニーズ ユースケースと想定される持続 req/s を添えて contact@twitterapi.io までメールしてください。 | ご相談ください |
プランを選ぶ？ /subscribe を参照してください — Starter、Builder、Pro の違いはクレジット付与量、チャージ時のボーナス %、ローリング方式のクレジット返還です。20 req/s を超える持続的なスループットが必要な場合、上限が上がるのは Scale (50 req/s) と Business (500 req/s) です。
バースト・トラフィック？ 上限に達すると HTTP 429 が返されます (Retry-After ヘッダーは送信されません)。1 秒ほど待ってから指数バックオフでリトライしてください。アカウントがブロックされることはありません。