TwitterのAPI呼び出しの回数制限を超えましたというエラーメッセージの意味と対処法

Twitterのサードパーティーアプリで「API呼び出しの回数制限を超えました」というエラーメッセージが表示されますか？このメッセージは、あなたのアカウントで、Twitter APIを使用しているサードパーティーアプリからの1時間のAPIの呼び出し回数が、上限に達したときに表示されます。Twitterではこのほかに、1日に可能なツイートの数、送信できるDMの数に新たな上限を設定し、さらに一般のユーザーに対しては、1日にフォローできるアカウント数に制限を設けました。一部のTwitterユーザーからは、バグでこのエラーメッセージが表示されているという報告も上がっています。Twitterで表示される「API呼び出しの回数制限を超えました」というエラーメッセージの意味と、エラーメッセージが出ないようにする方法を解説していきます（2023年7月にTwitterの名称がXに変更されました。この記事で解説している内容にも変更が生じる場合があるため、最新情報を公式ウェブサイト等で確認するようにしましょう）。

押さえるべきポイント

Twitter APIを使用しているアプリで、APIの呼び出し回数が上限に達すると「API呼び出しの回数制限を超えました」といメッセージが表示されます。
1日に、DMを500通以上送信したり、2,400件を超えるツイートをしたり、400個以上のアカウントをフォローしたりしても、同様のメッセージが表示されます。
バグや不具合でこのエラーが表示される場合もあるでしょう。

方法 1

方法 1 の 6:

「API呼び出しの回数制限を超えました」ってどういうこと？

PDF形式でダウンロード

1
このメッセージは通常、サードパーティーアプリにおいて、1時間のAPIの呼び出し回数が上限に達したときに表示されます。Twitter API（Application Programming Interface：アプリケーション・プログラミング・インターフェース）とは、サードパーティーアプリが、Twitterのサーバーに対して、情報をリクエストしたり送信したりする際に使われるものです。Twitterでは、各アカウントがサードパーティーアプリを使って、1時間にAPIを呼び出せる回数に上限を設けました。この上限が適用されるのはサードパーティーアプリについてのみで、Twitterの公式ウェブサイトやTwitterアプリには適用されません。^{[1]X出典文献}
- サードパーティーアプリからTwitterのサーバーにデータのリクエストがあれば、すべてAPIの呼び出しにカウントされます。DMのチェックも返信も、Twitterからのデータのリクエストも、APIの呼び出しとしてカウントされる仕組みです。ただし、Twitterへのデータの送信（投稿、DMの送信、「いいね」、フォローする／フォローを外す）はAPIの呼び出しとしてはカウントされません。
- サードパーティーアプリとは、利用にTwitterへのログインが必要なTwitter以外のアプリのことです。サードパーティーアプリには、TweetDeckなど、ツイートの管理や予約投稿を行えるものもあります。他のSNSサイトでは、複数のプラットフォームに投稿できるクロスポスト機能が実装されていますし、デスクトップアプリやウェブアプリ、スマホのウィジェットなどもサードパーティーアプリに含まれるでしょう。Twitterのデータの調査と解析のために開発された内部アプリもサードパーティーアプリになります。
- APIの呼び出し回数の上限に達してしまうと、サードパーティーアプリを使用できなくなりますが、Twitterの公式ウェブサイトとTwitterアプリは使用可能です。
2
Twitterを利用しすぎても、「API呼び出しの回数制限を超えました」というメッセージが表示される場合があります。Twitterはサービスの信頼性を維持し、システムが利用できなくなるダウンタイムの発生頻度を減らしていくために、いくつかの制限を設けました。そうしたTwitterリミットのうち、どれか1つでも上限を超えると、どの制限を超過したのかを具体的に通知するエラーメッセージが表示されるでしょう。^{[2]X出典文献}
- 1日あたりのツイート数の上限：2,400件
- 1日あたりに送信できるDMの数の上限：500通
- 1日あたりにフォローできるアカウント数の上限：400個
- 1アカウントでフォローできるアカウント数の上限：5,000個
- 1時間にアカウントの登録情報を変更できる回数：4回
広告

方法 2

方法 2 の 6:

APIの呼び出し回数の上限って何？

PDF形式でダウンロード

1
サードパーティーアプリでは、1時間あたり最大100回のAPIの呼び出しが可能です。ただし、1つの動作が複数回のAPIの呼び出しとしてカウントされる場合があります。例えば、ページの更新は3回のAPIの呼び出しとしてカウントされます。これはすべてのツイートやリプライ、DMの更新が含まれるためです。この100回の呼び出し回数の制限には例外もあり、以下にいくつか例を挙げます。^{[3]X出典文献}
- ユーザーによるTwitterリストの作成、削除、更新の理由に関する情報のリクエストについては、15分おきに300回のリクエストが可能です。
- ユーザーが誰をフォローしているか、誰に「いいね」をしているかに関する情報のリクエストであれば、15分おきに900回のリクエストが可能になっています。
- 誰がツイートを「いいね」したか、どのツイートに「いいね」をしたかに関する情報については、15分おきに75回リクエストができる仕組みです。

方法 3

方法 3 の 6:

APIの呼び出し回数に制限がある理由は？

PDF形式でダウンロード

1
TwitterがAPIの呼び出し回数に制限を設けたのにはいくつかの理由があります。Twitterがこの方針をとっている理由は以下の通りです。
- サーバーがダウンするのを防ぐため：Twitter上では常に大量のAPIの呼び出しが行われています。ユーザーのAPIの呼び出し回数に制限を設けることで、サーバーに過剰な負荷がかかるのを防ぎ、常に需要に応えられる状態を維持できるのです。
- スパムやハッキングを防ぐため：APIの呼び出し回数に上限を設定することで、大量のツイートという形でスパムが送信されるのを防ぐ効果があります。ハッカーによる分散型サービス拒否（DDoS）攻撃を防ぐこともできるでしょう。
広告

方法 4

方法 4 の 6:

バグや不具合の可能性はある？

PDF形式でダウンロード

過去に複数のユーザーのアカウントで、表示されるはずのないタイミングでエラーメッセージが表示されたという、Twitterサポートからの報告もあります。こうした不具合は、公式Twitterアプリやウェブサイト、サードパーティーアプリの利用、またはAPIの呼び出しを行っているときに起こることがあります。ただ、Twitter側もこの問題を把握しており、こうした不具合が発生した際には、迅速に復旧を行うべく尽力しています。^{[4]X出典文献}

方法 5

方法 5 の 6:

APIの呼び出し回数の上限に達しないようにする方法

PDF形式でダウンロード

利用しているアプリで設定が可能です。更新の回数が減ってしまいますが、1時間あたりのAPIの呼び出し回数も抑えることができます。
アカウントのエンゲージメントを追跡しているなら、検索ワードの単語数を減らしてみましょう。表示される検索結果が少ないワードは削除します。
検索結果を長期間に渡って使用する場合は、それらを保存しておきましょう。何度も同じ内容でAPIの呼び出しをせずに済みます。多くのアプリで検索結果の保存が可能です。
広告

方法 6

方法 6 の 6:

エラーメッセージが表示された場合の対処方法

PDF形式でダウンロード

Twitterでは1時間あたり100回のAPIの呼び出しが可能です。大抵の場合、数分待てば、再びアカウントが利用できるようになるでしょう。ツイート中やDMの送信中、ユーザーをフォローするタイミングでこのメッセージが表示された場合、24時間待たないとその作業は続行できません。アカウント情報の変更中にメッセージが表示された場合、さらなるアカウント情報の変更を行うまでに1時間待つ必要があります。
5,000個以上のアカウントをフォローしている場合、いくつかのアカウントのフォローを外さないと、新たなアカウントをフォローできません。
Twitter上でできる作業であれば、Twitter上で行いましょう。どんな場合でもこの方法がとれるわけではないでしょうが、Twitter APIの呼び出し回数制限は、サードパーティーアプリにのみ適用されるものです。
パスワードを設定しなおすことで、APIの呼び出し回数制限もリセットできたという報告がいくつか上がっています。これは本当に困っている場合にのみ行いましょう。新たなパスワードを覚えるよりも、またアカウントが使えるようになるのを待つほうが簡単なはずです。ただ、パスワードマネージャーを利用するなら、少しハードルが下がるかもしれません。
広告