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

TikTok エラー 40100:リクエストの頻度が高すぎます

TikTok エラー 40100 は、レート制限によってリクエストが抑制されたことを意味します。TikTok はこのコードを HTTP 200 の応答の本文に返すため、ステータスだけでは判別できません。対処法は、そのエンドポイントへの呼び出しを一時停止することです。分単位の制限の後は 5 分、日単位の制限の後は UTC 00:00 まで待ち、その後は少数のまとまったリクエストに切り替えます。

easyCoexistence は TikTok のコードとメッセージを Claude、ChatGPT、またはお使いのコードに返すため、AI はレート制限と投稿の失敗を区別し、再試行前に待機できます。

40100

レート制限に達すると TikTok が返すコードで、リクエストが抑制されたことを意味します。

HTTP 200

TikTok が返信コードとともに送るステータスです。40100 もこの形式で返され、成功を示すのは本文のコード 0 のみです。

40 QPM

各エンドポイントにおける、認可済み TikTok アカウントごとの Accounts API のレート制限です。

600 QPM

Basic レベルのデベロッパーアプリごとの、Accounts API 全エンドポイント合計の上限です。上位レベルでは 1,000 まで許可されます。

5 minutes

分単位の上限に達した後、再度呼び出すまでに TikTok が指定する待機時間です。

15 a day

アカウントが 1 日に API 経由で公開できる動画投稿の最大数で、1 分あたり最大 6 件です。

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

レート制限によってリクエストが抑制されたことを意味します。TikTok の戻りコード一覧では、40100 を「リクエストの頻度が高すぎます」と説明しています。これはデベロッパーアプリのレベルで、そのエンドポイントの上限に達したためです。レート制限ガイドでも、上限に達するとサーバーが 40100 を返すと記載されています。制限が解除されるまで、そのエンドポイントへの呼び出しは一時停止する必要があります。

コードで 40100 をどう検出しますか?

HTTP ステータスではなく、本文のコードで判断します。TikTok は戻りコードを HTTP 200 で返すため、各応答の code を確認してください。0 は成功、40100 は抑制されたリクエストを意味します。4xx は誤ったパスやメソッドを示し、5xx の場合 TikTok は再試行前に約 5 分待つよう勧めています:

Reading TikTok's answer in Node.js
// TikTok returns its error codes with HTTP 200: read code, not only the status.
async function callTikTok(url, accessToken) {
  const res = await fetch(url, { headers: { "Access-Token": accessToken } });
  if (res.status >= 500) return { retryInMs: 5 * 60_000 }; // TikTok: wait about 5 minutes
  if (!res.ok) throw new Error("HTTP " + res.status + ": check the path and the method");
  const body = await res.json();
  if (body.code === 40100) return { retryInMs: 5 * 60_000 }; // throttled: pause this endpoint
  if (body.code !== 0) throw new Error("TikTok " + body.code + ": " + body.message);
  return { data: body.data };
}

どの制限で 40100 が返りますか?

TikTok のレート制限ガイドでは、制限に達するとサーバーが 40100 を返すと記載されています。各制限は個別にカウントされ、アプリレベル別の完全な数値はレート制限のページにあります。Accounts API の呼び出しは 3 つの制限にカウントされます:

  • 各 Accounts API エンドポイントで、認可されたアカウントごとに毎分 40 クエリ。アプリのレベルに関係なく同じです。
  • Basic の場合はデベロッパーアプリごとに Accounts API 全体で毎分 600 クエリ、それ以上では 1,000 クエリです。
  • アプリのレベルで決まる、秒・分・日単位のエンドポイント別アプリ制限。

どのくらい待つべきですか?

どの制限に達したかによります。分単位の制限の後は、再度呼び出すまで 5 分待ちます。日単位の制限の後は翌日まで待ちます。日単位の制限は UTC 00:00:00 にリセットされるためです。TikTok のガイドによると、エンドポイント別の制限は互いに独立しているため、一つのエンドポイントの上限に達しても、他のエンドポイントへの呼び出しは止まりません。

1 日 15 件の投稿上限も同じ制限ですか?

いいえ。公開の上限は投稿数で数えられ、アカウントごとに各公開エンドポイントで 1 分あたり 6 件、1 日 15 件です。上限を超えた投稿は、40100 ではなく公開ステータスで spam_risk_too_many_posts により失敗します。TikTok がこの失敗に対して勧めているのは、TikTok のモバイルアプリから投稿を公開することです。詳細は投稿制限のページにあります。

制限内に収めるにはどうすればよいですか?

TikTok の推奨は、リクエストの回数を減らし、同時に実行する数を制限することです。Accounts API では、投稿を 1 件ずつ取得する代わりに、/business/video/list/ のページごとに最大 20 件の投稿を、/business/comment/list/ のページごとに最大 30 件のコメントを読み込みます。呼び出し同士はトークンバケットで間隔を空けるか、キューに入れて、決まった数のワーカーが送信するようにします。失敗したタスクは、遅延の後にキューへ戻します。

アプリレベルを上げれば 40100 は止まりますか?

アプリの上限に達していた場合に限ります。すべてのアプリは Basic から始まり、TikTok は「My Apps」「App Detail」「Authorization」の画面から理由を記載して申請すると、Advanced、Premium、Ultimate の順に 1 段階ずつ引き上げます。TikTok の Accounts API ガイドでは、アカウントとエンドポイントごとの毎分 40 の上限は、アプリのレベルとは別の一つの数値として示されています。そのため、利用の多いアカウントは呼び出し間隔を空けることで解決します。

よくある間違い

  • すぐに再試行すること。エンドポイントは制限が解除されるまで抑制されたままなので、素早い再試行は呼び出し回数を消費するだけで成功しません。
  • 投稿やコメントを 1 件ずつ取得すること。リスト呼び出しは最大 20 件の投稿または 30 件のコメントのページを返し、呼び出しごとに毎分 40 件の上限にカウントされます。
  • 公開ステータスを密なループでポーリングすること。確認のたびに /business/publish/status/ を呼び出すことになり、投稿 ID が表示されるまで最大 3 分かかることがあるため、確認の間隔を空けてください。
  • spam_risk_too_many_posts をレート制限として扱うこと。これは毎分の呼び出し数ではなく、過去 24 時間に API 経由で作成された投稿数を数えるため、呼び出しを遅くしても解決しません。
EasyCoexistence で実現する

ツールはコメントを 1 ページあたり 30 件、投稿を最大 20 件ずつ読み取ります。publish_tiktok_post は、TikTok が API からの投稿をアカウントごとに 1 日約 15 件に制限していることを、事前に AI に伝えます。接続 1 件あたり月額 US$ 9 から US$ 0.75 まで、接続を増やすほど料金が下がります。最初の 3 日間は無料トライアルです。

よくある質問

TikTok は、レート制限された呼び出しに HTTP 429 を返しますか?

TikTok のガイドでは、抑制された呼び出しは HTTP 200 の応答の本文にあるコード 40100 と説明されており、429 のステータスは記載されていません。そのため、各応答の code フィールドを確認してください。

TikTok の 40100 による抑制は、どのくらい続きますか?

分単位の上限に達した後は 5 分待つよう TikTok は勧めています。日単位の上限は UTC 00:00:00 にリセットされ、そのときに解除されます。

easyCoexistence は 40100 を返した呼び出しを自動で再試行しますか?

単独では再試行しません。抑制されたツール呼び出しは、コード 40100 と TikTok のメッセージを付けて AI に返されます。キュー内の抑制された投稿は、そのメッセージとともに失敗し、「要対応」に表示されて、「再試行」を選ぶまで待機します。

40100 と 40016 は違いますか?

TikTok の付録では、両方とも「デベロッパーアプリレベルでのリクエストの頻度が高すぎます」と同じ説明がされており、対処法も同じです。レート制限ガイドを確認してください。40133 は広告主レベルを扱います。

続きを読む

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

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

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

確認日