概要

スタンダード

毎日、数千人もの開発者がTwitter APIに対してリクエストを実行しています。こうした膨大な量のリクエストを管理しやすくするために、実行できるリクエストの数には制限が設けられています。こうした制限を設けることで、開発者コミュニティが安心して利用できる、信頼性と拡張性に優れたAPIの提供を実現しています。 

実行できるリクエストの最大数は一定の期間または時間間隔を1つの単位として設定されています。最も一般的なリクエスト制限間隔は15分です。エンドポイントのレート制限が15分あたり900リクエストの場合は、15分の間に900件までリクエストを実行できます。 

適用されるレート制限は使用している認証方法によって異なります。たとえば、OAuth 1.0aユーザーコンテキストを使用している場合、ユーザーのアクセストークン1セットにつき、1期間あたり1つの制限が適用されます。一方、OAuth 2.0ベアラートークンを使用している場合は、アプリによって実行されるリクエストに対して、1期間ごとに異なる制限が適用されます。これらの制限を超過するとエラーが返されます。ここからは、これらの制限の詳細と、レート制限を受けないようにするためのヒントを紹介していきます。 

レート制限と認証方法

開発者アプリとユーザーアクセストークン両方のレベルでレート制限が設定されています。

• OAuth 2.0ベアラートークン：開発者アプリ単位
  Twitter API v1.1のすべてのエンドポイントでこの認証方法を使用できます。そのため、開発者アプリに代わって特定数のリクエストをエンドポイントに対して実行する場合のみ、制限が適用されます。この認証方法を使用する場合は、ベアラートークンを使用して実行するリクエストの数によってレート制限が決定されます。エンドポイントでレート制限時間枠あたり450リクエストまで許可されている場合、ベアラートークンを渡すことで、アプリに代わって時間枠内に450回リクエストを実行できます。この制限はOAuth 1.0aユーザーコンテキストの制限とは完全に切り離してカウントされます。
  
  
• OAuth 1.0aユーザーコンテキスト：ユーザーアクセストークンセット単位
  ツイートの検索と最近の検索では、ユーザーに代わって認証を行うことができます。たとえば、ツイートからプライベートメトリックを取得する場合は、対象ユーザーに関連付けられているユーザートークンで認証する必要があります。このトークンは3レッグ認証OAuthフローを使用して生成できます。 10人のユーザーが開発者アプリを許可しており、各ユーザーに代わって15分の間に900回までリクエストを実行できる場合、これらのユーザーの代わりに9,000回までリクエストを実行できます。この制限はアプリケーション単位のベアラートークンの制限とは完全に切り離してカウントされます。