X（Twitter） APIの制限は？回避策はあります？

APIの制限とのことが、多くのユーザーはX（Twitter）を利用する時に、初めて聞くと思います。多くのユーザーは、X（Twitter）の利用中に、APIの制限に遭って、サービスを正常に利用できなくなったことがあるようです。それでは、X（Twitter）APIの制限はなんですか？なぜかX（Twitter）がAPIの制限を設けていますか？どのようにX（Twitter）APIの制限を回避すれば良いのですか？本文では、これらの問題について、皆さんに解説していきたいと思います。

X（Twitter） APIとは

X(Twitter) APIとは、Twitterのプラットフォーム上でデータや機能にプログラマティックにアクセスできるインターフェースのことです。X(Twitter) APIを通じて、様々な機能が実現されます。

• Twitterのタイムライン、ツイート、ユーザー情報などのデータにアクセスできる
• ツイートの投稿、いいね、リツイートなどの機能を利用できる
• 認証されたデベロッパーアカウントを使うことで、レートリミット(1時間当たりのリクエスト数)が高くなる
• REST APIとStreaming APIの2つが提供されている

REST APIは特定のエンドポイントにリクエストを送信する形で、Streaming APIはリアルタイムのデータストリームを受信できます。Twitter APIを使うことで、Twitterクライアントアプリや分析ツール、botsなどの開発が可能になります。ただし利用規約を遵守する必要があります。

X（Twitter）APIの制限について

2023年7月1日ごろ、X（Twitter）は急にAPIの利用を制限し始めました。X（Twitter）の制限を超えると、「API呼び出し回数制限を超えました」というエラーメッセージが表示され、正常にX（Twitter）を利用できなくなりました。

例えば、ポストを閲覧したり、新しいポストを投稿したりすることもできなくなって、完全に利用不可な状態になってしまいました。当時のX（Twitter） APIの制限について、異なるアカウントの種類に対して、異なる制限を課していました。

• 認証済みアカウントは、1日あたり6,000件の投稿を閲覧できる
• 未認証アカウントは、1日あたり600投稿まで閲覧できる
• 新しい未認証アカウントは、1日あたり300投稿まで閲覧できる

もちろん、X（Twitter）突然のAPI制限に多くのユーザーが不満を表明しましたので、1日後の2023年7月2日に、X（Twitter）側はAPIの制限を緩和しました。

• 認証済みアカウントは、1日あたり閲覧可能のポスト件数が6,000件から8000件に増えた
• 未認証アカウントは、1日あたり閲覧可能のポスト件数が600件から800件に増えた
• 新しい未認証アカウントは、1日あたり閲覧可能のポスト件数が300件から400件に増えた

2023年7月2日同日に、X（Twitter）APIの制限がさらに緩和されました。

• 認証済みアカウントは、1日あたり10,000件の投稿を閲覧できる
• 未認証アカウントは、1日あたり1,000投稿まで閲覧できる
• 新しい未認証アカウントは、1日あたり500投稿まで閲覧できる

また、2023年7月16日に、イーロン・マスク氏は自分のポストで認証済みのアカウントのレート制限を50％引き上げると表明することで、認証済みのアカウントは1日あたり15,000件の投稿を閲覧できるようになるのでしょう。

このようにして、「API呼び出し回数制限を超えました」というエラーが発生する頻率が著しく減少してきたので、X（Twitter）APIに関する不満もどんどん消えてきたかと思います。

また、2024年2月現在の制限について、X（Twitter）サービスの利用規約のページによりますと、その制限は、次のようになります。

• ポスト (ツイート) の投稿　　2,400件/1日
• ダイレクトメッセージ　　500件/1日
• ユーザーのフォロー　400件/1日
• 登録メールアドレスの変更　4回/1時間

Xリミットについて理解する | Xヘルプ

アカウントあたりのAPI利用回数、ツイート数、メッセージ数、フォロー数などのリミットと、リミットが使用される理由について説明します。

ヘルプセンター

また、X（Twitter）のAPIは、1日当たりではなく、15分間ごとにリクエスト件数を計算しているようです。詳しくは次のリンクからX（Twitter）APIの公式ドキュメントにアクセスして、X（Twitter）APIのレート制限を確認してください。

レート制限

レート制限 毎日、数千人もの開発者がTwitter APIに対してリクエストを実行しています。こうした膨大な量のリクエストを管理しやすくするために、実行できるリクエストの数には制限が設けられています。こうした制限を設けることで、開発者コミュニティが安心して利用できる、信頼性と拡張性に優れたAPIの提供を実現しています。 実行できるリクエストの最大数は一定の期間または時間間隔を1つの単位として設定されています。最も一般的なリクエスト制限間隔は15分です。エンドポイントのレート制限が15分あたり900リクエストの場合は、15分の間に900件までリクエストを実行できます。 適用されるレート制限は使用している認証方法によって異なります。たとえば、OAuth 1.0aユーザーコンテキストを使用している場合、ユーザーのアクセストークン1セットにつき、1期間あたり1つの制限が適用されます。一方、OAuth 2.0ベアラートークンを使用している場合は、アプリによって実行されるリクエストに対して、1期間ごとに異なる制限が適用されます。これらの制限を超過するとエラーが返されます。ここからは、これらの制限の詳細と、レート制限を受けないようにするためのヒントを紹介していきます。 目次 Twitter API v2のレート制限レート制限と認証方法HTTPヘッダーと応答コードレート制限を受けた場合の復旧方法レート制限を受けないようにするためのヒント Twitter API v2のレート制限 以下の表はTwitter API v2のレート制限をまとめたものです。これらのレート制限は、各エンドポイントのAPIリファレンスページにも記載されており、開発者ポータルの製品セクションにも表示されます。 リソースエンドポイント特に明記がない限り、15分間で実行できるリクエスト件数アプリあたりユーザーあたりツイートTweet lookup900900Manage Tweets- ツイートの投稿- ツイートの削除 20050 Timelines- ユーザーのツイートタイムライン- ユーザーの@ツイートタイムライン- 新しい順のホームタイムライン 1,500450 900180180Search Tweets - 最新の検索 - Full-Archive Search 450300 Full-Archiveには1秒あたり1リクエストの制限もあり 180Tweet counts- 最新のツイート数- Full-Archiveのツイート数 300300 Filtered stream- 接続- フィルターの追加/削除 - フィルターの一覧表示 50Essentialアクセス - 25Elevatedアクセス - 50Academic Researchアクセス - 100Enterpriseアクセス - 450450 Volume streams- サンプル対象ストリーム 50 Retweets lookup7575Quote Tweets lookup7575Manage Retweets**- ツイートへのリツイート- リツイートの取り消し 5050 Bookmarks lookup180 Manage Bookmarks- ツイートのブックマーク- ブックマークの取り消し 5050 いいねの検索 - ユーザーがいいねしたツイート- ツイートにいいねしたユーザー 7575 7575ツイートの管理** - ツイートの作成- ツイートの削除 20050いいねの管理** - ツイートへのいいね- ツイートへのよくないね 5050返信の非表示50 ユーザーUser lookup- 認証済みユーザーの検索900 90075Follows lookup1515Manage follows**- ユーザーのフォロー- ユーザーのフォロー解除 50 50Blocks lookup 15Manage blocks- ユーザーのブロック- ユーザーのブロック解除 5050Mutes lookup 15Manage mutes- ユーザーのミュート- ユーザーのミュート解除 5050リストManage Lists- リストの作成- リストの削除- リストの更新 300300300List lookup- IDを基準にしたリストの取得- ユーザー所有リストの取得 7515 7515List Tweets lookup900900List members- メンバーの追加- メンバーの削除- リストメンバーの取得- ユーザーのリストメンバーシップの取得 90075 30030090075List follows- リストのフォロー- リストのフォロー解除- リストフォロワーの取得- ユーザーのフォロワーリストの取得 18015 505018015Manage pinned Lists- リストの固定- リストの固定解除- ユーザーの固定リストの取得 505015スペースSpaces lookup300 Search Spaces300 コンプライアンスBatch compliance- ジョブの作成- ジョブの取得- IDを基準にしたジョブの取得 150150150 **次のPOSTエンドポイントとDELETEエンドポイントには、レート制限に加えて操作制限もあります。 ツイートの管理 Tweet CreateCreate Retweetで共有されたユーザー1人につき、3時間の時間枠のなかで300件までリクエストを実行可能（失敗したリクエストはカウント対象外）リツイートの管理 Create RetweetTweet Createで共有されたユーザー1人につき、3時間の時間枠のなかで300件までリクエストを実行可能（失敗したリクエストはカウント対象外）Delete Retweetユーザー1人につき、24時間の時間枠のなかで1,000件までリクエストを実行可能（失敗したリクエストはカウント対象外）いいねの管理 Like a Tweetユーザー1人につき、24時間の時間枠のなかで1,000件までリクエストを実行可能（失敗したリクエストはカウント対象外）（この制限では、Like a TweetエンドポイントとDelete Likeエンドポイントの両方がカウント対象になります）Delete Likeフォローの管理 Follow a userユーザー1人につき、24時間の時間枠のなかで400件までリクエストを実行可能（失敗したリクエストはカウント対象外）アプリ1つにつき、24時間の時間枠のなかで1,000件までリクエストを実行可能（失敗したリクエストはカウント対象外）Unfollow a userアプリ1つにつき、24時間の時間枠のなかで500件までリクエストを実行可能（失敗したリクエストはカウント対象外） 注 レート制限に加え、特定のエンドポイントからプロジェクトが1か月間で取得できるツイート数をアクセスレベルに基づいて制限するツイート上限もあります。 レート制限と認証方法開発者アプリとユーザーアクセストークン両方のレベルでレート制限が設定されています。 OAuth 2.0ベアラートークン：アプリのレート制限 この認証方法とレート制限では、開発者アプリに代わり、エンドポイントに対して特定数のリクエストを実行できます。この認証方法を使用する場合は、ベアラートークンを使用して実行するリクエストの数によってレート制限が決定されます。 エンドポイントでアプリのレート制限が15分あたり450リクエストの場合、ベアラートークンを使用するとアプリに代わって15分間に450回リクエストを実行できます。 この制限はユーザーのレート制限とは完全に切り離してカウントされます。 OAuth 1.0aユーザーコンテキスト：ユーザーのレート制限この認証方法とレート制限では、リクエストを認証する際に使用したユーザーアクセストークンによって特定されたTwitterに代わって、一定数のリクエストをエンドポイントに対して実行できます。たとえば、ツイートからプライベートメトリックを取得する場合は、対象ユーザーに関連付けられているユーザーアクセストークンで認証する必要があります。このトークンは3レッグ認証OAuthフローを使用して生成できます。 10人のユーザーが開発者アプリを許可しており、リクエストの実行先となるエンドポイントでレート制限が15分あたり900リクエストの場合、ユーザー1人につき15分で最大900回リクエストを実行でき、リクエストの合計件数は9,000件となります。 この制限はアプリのレート制限とは完全に切り離してカウントされます。 注 ユーザーのレート制限はユーザーが許可しているすべてのアプリでカウントされます。たとえば、あるユーザーが15分の間にある開発者アプリを使って20件のツイートにいいねし、別の開発者アプリで20件のツイートにいいねした場合、合計40件のリクエストがそのユーザーのレート制限としてカウントされます。つまり、このエンドポイントのユーザーレート制限が15分あたり1,000リクエストの場合、Twitterとサードパーティのアプリを合計して、24時間の時間枠のなかでこのユーザーはあと960件のツイートにいいねできることになります。 HTTPヘッダーと応答コードアプリケーションが利用された方法でアプリケーションの現在のレート制限を確認するには、HTTPヘッダーを使用します。 HTTPヘッダーの内容は状況に応じて変化します。アプリケーション専用の認証を使用する場合、アプリケーションのコンテキストに合わせたレート制限がHTTPヘッダーに記載されます。ユーザーベースの認証を使用する場合、そのユーザーのコンテキストに合わせたレート制限がHTTPヘッダーに記載されます。 x-rate-limit-limit:そのエンドポイントのレート制限の上限x-rate-limit-remaining:15分の間に実行できる残りリクエスト件数x-rate-limit-reset:レート制限がリセットされるまでの残り時間（単位はUTCのエポック秒） 特定のTwitter APIエンドポイントでアプリケーションがレート制限を超過した場合、APIから応答コードHTTP 429 “Too Many Requests”が返され、応答本文で次のエラーが返されます。{ "errors": [ { "code":88, "message":"Rate limit exceeded" } ] } レート制限にかかった場合の復旧方法これらのレート制限を超過すると、429 'Too many requests'エラーがエンドポイントから返されます。 これから説明するとおり、レート制限のエラーが発生した場合は、制限がリセットされるタイミングが記載されたHTTPヘッダーを確認し、制限がリセットされるまでリクエストを一時停止することをおすすめします。 「Too many requests」かレート制限のエラーが発生した場合は、リクエストを実行する頻度を下げる必要があります。レート制限のエラーが発生した場合は、 x-rate-limit-reset: HTTPヘッダーを確認することで、レート制限がリセットされるタイミングがわかります。 よく見られるもう1つのパターンがエクスポネンシャルバックオフです。エクスポネンシャルバックオフでは、あるリクエストから次のリクエストまでの時間が最初は短く（数秒など）、再試行のたびに時間が倍になっていきます。リクエストが成功するか、あるリクエストから次のリクエストまでの合理的な最長時間（たとえば、数分）に達するまでこれが続けられます。 クライアント側で既存のレート制限を認識させ、現在超過している時間枠が過ぎるまでリクエストを一時停止できるようにしておくことをおすすめします。15分の制限が過ぎたら、そこから1～2分待ってから再試行するのが良いでしょう。リクエスト数に関するこれらの制限を超過した場合、スタンダードベーシックレベルのアクセスによって、最近の検索とフィルタリングされたストリームエンドポイントから1か月あたり50万ツイートが提供されます。ツイート数に関する月間上限を超過した場合、アプリに通知が出るようにして、1か月のなかでどの日が登録日かわかるようにし、その日までリクエストを遅らせることをおすすめします。 レート制限を受けないようにするためのヒントこれから紹介するヒントは、コードを保守的に記述し、レート制限を受ける可能性を抑えるためのものです。実現したいと考えている一部のアプリケーション機能（特に最新の結果を表示するためのもの）はレート制限の観点から実現不可能です。情報をリアルタイムで表示することがアプリケーションの目的である場合は、フィルタリングおよびサンプリングされたストリームエンドポイントを検討してください。 キャッシュ多用が想定される場合、アプリケーションまたはサイトにAPI応答を保存してください。たとえば、ウェブサイトのランディングページでページを読み込むたびにTwitter APIを呼び出すのは避けてください。代わりに、APIの呼び出し頻度を下げ、応答をローカルキャッシュに読み込んでください。こうすることで、ユーザーがウェブサイトにアクセスした時に、キャッシュされたバージョンの結果が読み込まれるようになります。 アクティブユーザーを優先するサイトで多数のTwitterユーザーを追跡している場合（ユーザーの現在のステータスやTwitterの使用状況に関する統計情報を取得しているなど）は、サイトに最近サインインしたユーザーに絞ってデータをリクエストすることを検討してください。 検索結果に合わせて調整するアプリケーションで大量の検索語句をモニタリングしている場合は、ヒットする結果があるものよりもヒットしない検索のクエリ頻度を下げてください。クエリ頻度を下げることで、人気のあるクエリの最新状況を常に把握しながら、ほとんど変化のないクエリのリクエストを繰り返し行わなくて済むようになります。または、フィルタリングされたストリームエンドポイントと検索クエリによるフィルターの使用を検討してください。 拒否リストレート制限に違反したアプリケーションは拒否されます。拒否されたアプリはTwitter APIから応答を取得できません。ご自身、またはアプリケーションが拒否され、それが間違いであると思われる場合は、プラットフォームサポートフォームを使用してサポートを依頼できます。次の情報をお伝えください。 アプリケーションが拒否されたと考える理由を説明してください。レート制限に現在かかっていない場合は、問題を修正した方法を詳しく説明してください。 次の手順 ツイート上限の詳細を確認する 開発者利用規約 @twitterdevjpをフォロー 開発者向けニュースを購読 Xプラットフォーム X.com 障害情報 アクセシビリティ ポストを埋め込む プライバシーセンター 透明性センター Xアプリをダウンロード X Corp. Xについて Xニュース ブランドツールキット 採用情報 投資家の皆さま ヘルプ ヘルプセンター X活用法 Xクリエイター 広告ヘルプセンター アカウントの管理 メールプリファレンスセンター ルールとポリシー お問い合わせ 開発者向け参考資料 開発者ホーム ドキュメンテーション フォーラム コミュニティ 開発者ブログ エンジニアリングブログ 開発者利用規約 企業向け参考資料 広告 Xのビジネス活用 参考資料とガイド Xマーケティング マーケティングインサイト ブランド活用事例 X Ads Academy © 2024 X Corp. Cookie プライバシー 利用規約 誰か・・・Cookieって言いましたか？ XとそのパートナーはCookieを使用して、より高品質で安全かつ 迅速なサービスを提供しており、また、Cookieの使用は私たちのビジネスを支えています。Cookieの中には、Xのサービスをご利用いただくため、 サービス改善のため、そしてサービスが適切に動作することを確実にするために必要となるものがあります。ユーザーが選択できるオプションの詳細については あなたの選択肢の詳細を見る。​ 全てのCookieを受け入れる 不要なCookieを拒否する

なぜX（Twitter）はAPI制限を設ける？

それでは、X（Twitter）はAPIに制限を課す原因はなんでしょうか？2023年7月5日のX(Twitter) 社の公式声明によりますと、主に2つの原因があると言われています。

1. AIモデルを構築するために人々の公開されているTwitter上のデータをスクレイピングすることを防ぐ
2. 様々な方法でプラットフォーム上の人々や会話を操作することを防ぐ

Twitter Rate Limitsに関するアップデート

ほんの一瞬でも、スピードアップのために速度を落とさなければならないこともあります。

ビジネスTwitter

X（Twitter）API制限を回避する方法

それでは、もしX（Twitter）API制限を超えてしまい、サービスを利用できなくなった場合、どうしたらいいですか？この部分では、役に立つ対策を皆さんに紹介します。

アカウントをアップグレード

先に紹介したように、各アカウント種類に対して、X（Twitter）API制限も違っていますので、より高級のプランにアップグレード（未認証のアカウントを認証済みのアカウントにアップグレードなど）することで、X（Twitter）APIの制限を解除することができます。つまり、課金して有料プランであるXプレミアムを購入する必要がありますね。

しばらく待っておく

APIの呼び出し回数を超えてしまった場合、時間が経過すれば、その制限が解消されますので、有料プランであるXプレミアムを購入することを考えない方は、このAPI制限がリセットされるまで、しばらく待っておく必要がありますね。一般的には、1日経過後、X（Twitter）サービスが再び利用できるようになります。

X（Twitter）の代わりにそのAPIを直接に利用する

前述のように、普段のX（Twitter）サービスは、1日を単位に制限を課していますが、APIを利用する場合は、15分間を単位に制限を課しているようになります。ということで、X（Twitter）APIを利用している場合、使用ニーズが激増して、制限に達しても、15分間後にこの制限がリセットされ、再び利用できるようになると思います。

そこで、X（Twitter）のアプリかウェブサイトでサービスを利用できなくなる場合、どうしてもX（Twitter）を引き続き利用したいと思っている方は、X（Twitter）APIを利用することをお勧めします。

ApidogでX（Twitter）APIを利用・テストする

それでは、X（Twitter）APIを利用するには、どうしたらいいですか？X（Twitter）APIの利用手順を解説する前に、X（Twitter）APIがどのような場面で役立つのかを解説していこうと思います。

X（Twitter）APIの利用シーン

一般ユーザーに対して、X（Twitter）APIの利用シーンはそんなに多くないと思いますが、開発者にとってX（Twitter）APIをよく扱う必要があります。例えば、次のような利用シーンがある場合、X（Twitter）APIを利用することが必要となります：

• Twitterクライアントアプリの開発
• Twitterの公式アプリ以外に、第三者が開発するiOS/Androidアプリケーション
• 分析ツールの開発
• ツイートやトレンドの分析、ユーザー属性の分析などを行うツール
• マーケティング・広報への活用
• 企業アカウントの運用、インフルエンサーとのタイアップ、Twitterを使ったプロモーションなど
• カスタマーサポート
• Twitter上での顧客からの問い合わせ対応など
• botsや自動投稿ツールの開発
• 特定のキーワードを监視して自動反応したり、定期的に自動投稿を行うツール
• その他
• Twitter上でのイベント配信、認証連携によるサービス登録、研究用途など幅広い利用がされています。

X（Twitter）APIへのアクセストークンを取得

X（Twitter）APIにアクセスするために、API認証が必要となります。Twitterの公式APIドキュメントを参照しながら、以下の手順でAPIにアクセスできます。

1.開発者アカウントを作成する

TwitterのDeveloperPortalにアクセスし、開発者アカウントを作成します。質問に答え、用途を説明する必要があります。

2.プロジェクトとアプリを作成する

開発者アカウントでプロジェクトを作成し、そのプロジェクト内でアプリを作成します。

3.認証情報を取得する

アプリページから、以下の認証情報を取得できます。

• APIキーとシークレット (OAuth 1.0a)
• アクセストークンとシークレット (OAuth 1.0a)
• クライアントIDとシークレット (OAuth 2.0)
• ベアラートークン (OAuth 2.0)

OAuth 1.0aかOAuth 2.0を使い、リクエストに対して適切な認証を行うと、公式ドキュメントのエンドポイント仕様を確認し、必要なパラメータを付けてAPIを呼び出します。

ご案内 :APIキーやトークンは、TwitterのDeveloperPortalで一回のみ表示されますので、これらの情報を安全に保管する必要がありますので、注意を払ってください。

X（Twitter）APIの利用・テスト手順

X（Twitter）APIを利用するには、まずはX（Twitter）のAPIドキュメントを確認して、APIアクセストークンそして、適切なAPIクライアントツールを使用して、APIを利用したり、テストしたりする必要があります。一番便利な方法は、使いやすいAPI管理ツールのApidogを利用することです。

Apidogは、API Hubというサービスを提供しているので、このAPI Hubでは、X（Twitter）APIプロジェクトが見つけられます。次のリンクから、API HubのX（Twitter）APIのページにアクセスすると、直ちに利用＆テストできます。

Returns the open api spec document. - Twitter API v2

Full open api spec in JSON format. (See https://github.com/OAI/OpenAPI-Specification/blob/master/README.md)

Apidog

このページでは、X（Twitter）APIのすべてのエンドポイントが表示されるので、必要に応じて、必要なエンドポイントを選択して、「Try it out」をクリックして、すぐにリクエストを送信することができます。また、「Run in Apidog」ボタンをクリックして、X（Twitter）APIをApidogで開いて、自分のプロジェクトに追加したりすることもできるので、非常に便利です。

まとめ

この記事では、Twitter APIの制限について詳しく解説しました。Twitter APIとはTwitterのプラットフォームをプログラミティックに利用するインターフェースのことで、様々な開発に用いられています。しかし、Twitterは規制のためにAPIの利用に制限を課しています。制限を超えるとエラーが発生し利用できなくなるため、アカウントのアップグレードや待機などの対策が必要です。

X（Twitter）APIの利用やテストに便利なツールとして、Apidogという直感で使いやすいAPIツールを試してみましょう。