ログイン無料トライアルを開始
easyCoexistence 公式 API

Facebook Graph API のレート制限:エラー 4、17、32、613、80001

Facebook の Graph API は、ページのアクセストークンまたはシステムユーザーのトークンに対し、直近 24 時間で、ページに反応したユーザー 1 人につき 4,800 回の Pages API 呼び出しを許可します。上限を超えると、次のコードが返されます。4 は「Application request limit reached」、17 は「User request limit reached」、32 は「Page request limit reached」、613 は「Calls to this api have exceeded the rate limit」、80001 は「There have been too many calls to this Page account」です。呼び出しを止めてから、少しずつ再開してください。

easyCoexistence は、接続された各ページに、そのページ自身のトークンで呼び出しを行い、Meta の Webhook を通じてフィードの動き、メンション、メッセージを受け取ります。

4

リクエストで使われたトークンのアプリが、レート制限に達したときのコードです。

17

リクエストで使われたトークンのユーザーが、自分のレート制限に達したときのコードです。

32

Pages API リクエストで使われたトークンのユーザーまたはアプリが、レート制限に達したときのコードです。

613

カスタムレート制限のコードです。サブコード 1996 の場合、Meta はアプリのリクエスト量に一貫性のない動作を検出しています。

80001

ページのアクセストークンまたはシステムユーザーのアクセストークンで行われた Page 呼び出しの、Business Use Case のコードです。

4,800 × engaged users

ページのトークンまたはシステムユーザーのトークンで、直近 24 時間に許可される Pages API 呼び出し数です。

各レート制限のコードは何を意味しますか?

各コードは、到達した上限の名前を示します。どの上限が適用されるかは、リクエストに含まれるトークンで決まります。レート制限に関する Meta のガイドには各コードの意味が説明されており、そのエラーリファレンスには付随するメッセージが載っています。以下に、Meta の表記どおりのメッセージとともに一覧します:

Meta's messageWhat reached its limit
4Application request limit reachedThe app whose token made the request
17User request limit reachedThe user whose token made the request
32(#32) Page request limit reachedThe user or app token used in a Pages API request
613(#613) Calls to this api have exceeded the rate limit.A custom limit set by the API being called
80001(#80001) There have been too many calls to this Page account. Wait a bit and try again.Calls made on that Page with a Page or system user token

ページには、どの上限が適用されますか?

トークンによって異なります。Meta によると、ページのレート制限は、使われたトークンの種類に応じて Platform のロジックか Business Use Case のロジックのどちらかが適用されます。ページのアクセストークンまたはシステムユーザーのトークンによる Pages API 呼び出しには、ページ向けの Business Use Case の上限が適用されます。一方、ユーザーのトークンやアプリのトークンによる呼び出しには、そのユーザーまたはアプリの Platform の上限が適用されます。両方が当てはまるリクエストでは、Meta は Business Use Case の上限を適用します。

上限はどのくらいですか?

Meta は固定の数値ではなく計算式を公開しているため、上限は利用に応じて増えます:

  • アプリ:デイリーアクティブユーザー 1 人あたり 1 時間に 200 回。ユーザーごとではなく、アプリのすべての呼び出しを合算して数えます。
  • ページ(ページのトークンまたはシステムユーザーのトークンを使用):ページに反応したユーザー 1 人あたり、直近 24 時間で 4,800 回。
  • Messenger Send API:ページごとに毎秒 300 回。テキスト、リンク、リアクション、スタンプが対象です。音声や動画は毎秒 10 回です。
  • Messenger の呼び出しには、独自の Business Use Case の種類もあり、エラー 80006 として報告されます。

上限に近づいていることは、どうすればわかりますか?

使用状況ヘッダーを確認してください。アプリからの呼び出しを十分に受けるエンドポイントは X-App-Usage を返します。その call_count、total_cputime、total_time は、アプリの Platform の上限に対する使用率です。Business Use Case のロジックでレート制限されたレスポンスには、代わりに X-Business-Use-Case-Usage が含まれます。これには、ビジネスオブジェクトごとの同じ使用率、pages などの上限の種類、そして estimated_time_to_regain_access が含まれます。

The two usage headers (Meta's sample X-App-Usage values; illustrative values for the Page)
X-App-Usage: {"call_count": 28, "total_time": 25, "total_cputime": 25}

X-Business-Use-Case-Usage: {
  "{business-object-id}": [
    {
      "type": "pages",
      "call_count": 100,
      "total_cputime": 34,
      "total_time": 41,
      "estimated_time_to_regain_access": 12
    }
  ]
}

どのくらい待てばよいですか?

使用量が下がるまで待ちます。その推移はヘッダーで確認できます。80001 のような Business Use Case の上限では、estimated_time_to_regain_access が、呼び出しが制限されなくなるまでの分数を示します。Platform の上限では、アプリの call_count は直近 1 時間を対象としており、古い呼び出しが期限切れになるにつれて減ります。Meta の指針は両方に共通しています。上限に達したら呼び出しを止めてください。呼び出しを続けると、呼び出し回数と、呼び出しが再び成功するまでの時間が増え続けるためです。

上限の範囲内に収めるには、どうすればよいですか?

呼び出しの回数を減らし、軽くし、時間を分散させてください。Meta のベストプラクティスは、トラフィックの急増を避けるためにクエリを均等に分散させること、フィルターを使ってレスポンスの大きさを抑え、重複するデータを要求する呼び出しを避けること、そして、ユーザーが制限を受けている場合はアプリ自体が原因になっていないか確認することです。Webhook も役立ちます。Meta はページのフィード上の動きやメッセージを発生した時点で配信するため、アプリが呼び出しを使ってそれらを探す必要がなくなります。

よくある間違い

  • すぐに再試行すること。Meta は、呼び出しを続けると呼び出し回数と再び成功するまでの時間が増えると警告しています。
  • すべてのコードを同じように扱うこと。4 はアプリの上限、17 はユーザーの上限、80001 はページの上限なので、誤った呼び出し元の速度を落としても、何も変わりません。
  • ページのトークンによる呼び出しで X-App-Usage を読むこと。それらは Business Use Case の上限に含まれ、X-Business-Use-Case-Usage に報告されます。
  • 反応の少ないページを頻繁にポーリングすること。ページの呼び出し枠は、そのページに反応したユーザー数に応じて増えるため、反応の少ないページは使える呼び出しが少なくなります。
EasyCoexistence で実現する

必要であればお使いのエンドポイントに転送できるため、ページを定期的に問い合わせる必要はありません。Meta が呼び出しを制限した場合、このツールは Meta のコードとメッセージを Claude、ChatGPT、またはご自身のコードに返すので、AI は再試行の前に待つことができます。Meta が制限した投稿は、5 分後、30 分後、2 時間後に自動で再試行されます。料金は接続済みの番号 1 件あたり月額 US$ 9 から、番号を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料です。

よくある質問

Application request limit reached とはどういう意味ですか?

エラー 4 です。呼び出しに使われたトークンのアプリが、レート制限に達したことを意味します。呼び出しを止め、使用量が下がるにつれて少しずつ再開してください。

エラー 32 と エラー 80001 の違いは何ですか?

違いはトークンです。エラー 32 は、ユーザーまたはアプリのトークンで Pages API を呼び出したときの Platform の上限です。80001 は、ページのアクセストークンまたはシステムユーザーのトークンによる呼び出しに対する、ページごとの上限です。

Facebook のレート制限は、どれくらい続きますか?

Meta は固定の時間を設定していません。80001 の場合、X-Business-Use-Case-Usage ヘッダーに、呼び出しが制限されなくなるまでの分数が示されます。アプリの使用量は直近 1 時間で計測されます。

エラー 613 は何を意味しますか?

呼び出される API が設定した、カスタムのレート制限です。サブコード 1996 の場合、Meta はアプリのリクエスト量に一貫性のない動作を検出しています。たとえば、最近アプリが送信するリクエスト数を変えた後などです。

続きを読む

最初のチャンネルを 2 分で接続しましょう。

プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。

  • 3 日間無料
  • いつでも解約可能
  • 公式 API のみ使用
  • 24/7 監視

確認日