Instagram API のレート制限: 24 時間あたりの呼び出し数と DM の処理速度
Instagram の API は、アプリごと・アカウントごとに呼び出しの上限を設けています。上限は、直近 24 時間におけるそのアカウントのインプレッション数に 4,800 を掛けた数です。メッセージ送信には、アカウントごとに別の速度制限があります。Send API ではテキストメッセージを毎秒 100 件、音声や動画は毎秒 10 件まで送信でき、プライベートリプライは 1 時間に 750 件までです。上限を超えると、呼び出しはエラー 80002 で失敗します。X-Business-Use-Case-Usage ヘッダーで使用状況を確認できます。
easyCoexistence は、各 Instagram アカウントのコメント、メンション、DM が届くたびに、お使いのエンドポイントへ転送できます。
インプレッションあたり、一つのアプリが一つのアカウントに対して直近 24 時間に行える呼び出し数。メッセージ送信は含まない。
投稿やリールへのコメントに対するアカウントごとのプライベートリプライ数。ライブのコメントは毎秒 100 件まで。
テキスト、リンク、リアクション、スタンプの Send API 呼び出し数(アカウントごと)。音声や動画は毎秒 10 件。
API で公開した投稿のアカウントごとの件数(24 時間の移動期間)。コンテナの公開時に適用されます。
Instagram の Business Use Case レート制限に達したときに、アプリが受け取るエラーコード。
Instagram は API 呼び出しをどのように数えますか?
アプリとアカウントの組み合わせごとに、直近 24 時間で数えられます。Instagram のエンドポイントは Meta の Business Use Case レート制限の対象です。プロフェッショナルアカウント 1 件に対するアプリの呼び出し数の上限は、4,800 にそのアカウントのインプレッション数を掛けた値です。インプレッション数とは、直近 24 時間にそのアカウントのコンテンツが誰かの画面に表示された回数を指します。メッセージは別に数えられ、Business Discovery と Hashtag Search には Meta のプラットフォームのレート制限が適用されます。
あるアカウントの利用は、別のアカウントに影響しますか?
この計算式では影響しません。Meta はアプリとアプリユーザーの組み合わせごとに数を保持するため、多数のプロフェッショナルアカウントにサービスを提供するアプリには、アカウントごとに別の上限があります。その上限は、各アカウント自身のインプレッション数で決まります。コンテンツが多く見られるアカウントほど多くの呼び出しができ、新しいアカウントや閲覧の少ないアカウントは少なくなります。
メッセージの制限はどうなっていますか?
24 時間の集計とは別に、Instagram のプロフェッショナルアカウントと API ごとに設定されています:
- Send API: テキスト、リンク、リアクション、スタンプは毎秒 100 回、音声や動画は毎秒 10 回まで。
- プライベートリプライ: 投稿やリールへのコメントは 1 時間に 750 回、ライブのコメントは毎秒 100 回まで。
- Conversations API: 毎秒 2 回。
公開上限はどこに当てはまりますか?
呼び出しの上限とは別に、投稿数を数える仕組みとして存在します。Meta の公開ガイドでは、24 時間の移動期間内にアカウントあたり API で公開できる投稿は 100 件です。これは POST /<IG_ID>/media_publish が呼び出されたときに確認され、上限を超える呼び出しはコード 9、サブコード 2207042 で失敗します。投稿に含められるものやコンテナ数、content_publishing_limit は、公開上限のドキュメントで扱います。
Meta は使用状況をどのように伝えますか?
レスポンスヘッダーで伝えます。Business Use Case の上限内での呼び出しは、ID をキーとする JSON 文字列の X-Business-Use-Case-Usage を返します。Instagram の場合、その type は instagram です。call_count、total_cputime、total_time は、許容量に対して使用された割合(パーセント)です。CPU 時間または合計時間が 100 に達すると、呼び出しが制限されることがあります。estimated_time_to_regain_access は、制限中のアプリが再び呼び出せるまでの残り時間を分単位で示します。
x-business-use-case-usage: {
"<ID>": [
{
"type": "instagram",
"call_count": 28,
"total_cputime": 12,
"total_time": 15,
"estimated_time_to_regain_access": 0
}
]
}上限に達するとどうなりますか?
数が上限を下回るまで、呼び出しは失敗します。Instagram の Business Use Case の上限に対するエラーコードは 80002 です。Meta は、制限中に行われた呼び出しも数に加算されると警告しています。そのため、呼び出しが再び成功するまでの時期が遅れます。メッセージは、この予算とは別に、秒単位と時間単位のそれぞれの速度制限で数えられます。
上限の内側に収めるにはどうすればよいですか?
Meta 自身の推奨を Instagram に当てはめると、次のとおりです:
- コメント、メンション、メッセージは、ポーリングではなく Webhook で受け取ってください。Meta は、これによりアプリが必要とする呼び出しを減らせるとして推奨しています。
- 呼び出しは、まとめて送らず均等に分散してください。
- 必要なフィールドだけを要求し、重複するデータの要求は避けてください。
- バッチ内のリクエストは、それぞれ個別の呼び出しとして数えてください。Meta はバッチ内の各リクエストを一つの呼び出しとして数えます。
- 制限されたら停止し、
estimated_time_to_regain_accessの時間が経過してから再開してください。
よくある間違い
- 制限中の呼び出しをループで再試行すること。Meta は制限中の呼び出しも数えるため、呼び出しが再び成功する時期が遅れます。
- 新しいコメントや DM をポーリングすること。Webhook は発生した時点で配信し、呼び出し数を抑えます。
- estimated_time_to_regain_access を秒単位と読むこと。Meta はこれを分単位で返すため、その数の秒だけ待つクライアントは、まだ制限中に再び呼び出してしまいます。
- call_count だけを監視すること。total_cputime と total_time も制限の対象に数えられるため、ヘッダーに含まれる 3 つの割合すべてを追跡してください。
そのため、エージェントはポーリングせずイベントに反応できます。Meta が呼び出しを制限すると、Claude、ChatGPT、またはご自身のコードは、Meta のエラーコードとメッセージを受け取ります。また、接続済みの各アカウントを 6 時間ごとに確認します。料金は接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
Instagram アカウントは 1 日に何回 API を呼び出せますか?
直近 24 時間にそのアカウントのコンテンツが持っていたインプレッション 1 件あたり 4,800 回です。アプリとアカウントの組み合わせごとに数えるため、より多く見られるアカウントほど多くの呼び出しができます。
Instagram API エラー 80002 とは何ですか?
Instagram の Business Use Case レート制限です。そのアカウントに対して、アプリが呼び出し上限を使い切ったことを示します。呼び出しを止め、使用状況ヘッダーが示す時間を待ってください。
DM は 4,800 の計算式に含まれますか?
いいえ。メッセージはこの計算式から除外され、アカウントごとに独自の速度制限があります。たとえば、Send API ではテキストメッセージを毎秒 100 件送信できます。
プライベートリプライは DM と同じ速度制限を共有しますか?
いいえ。Meta は別の制限を設けています。投稿やリールへのコメントは、アカウントごとに 1 時間あたり 750 回、ライブのコメントは毎秒 100 回です。これは DM 向けの Send API の速度制限とは別です。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日