TikTok API のレート制限: アカウント・アプリ・エンドポイント別の上限
TikTok の API for Business は、3 つのレベルで同時に呼び出し回数を制限します。認証済みアカウントごとに Accounts API の各エンドポイントで毎分 40 回、開発者アプリ単位では Accounts API 全体の共有枠が Basic で毎分 600 回、それ以上のレベルで毎分 1,000 回です。さらに、エンドポイントごとのアプリ制限として、Basic では毎秒 10 回、毎分 600 回、1 日 864,000 回があり、Ultimate では毎秒 50 回まで上がります。
easyCoexistence は、Claude、ChatGPT、またはご自身のコードから、TikTok の API for Business を通じて TikTok の投稿を公開し、インサイトを読み取り、コメントに返信します。
認証済みの TikTok アカウントごとに、Accounts API の各エンドポイントで毎分のクエリ数。アプリのレベルには左右されない一定の値です。
Advanced、Premium、Ultimate の開発者アプリでは、Accounts API のすべてのエンドポイントを合計した枠。Basic は 600 です。
最上位のアプリレベル Ultimate のエンドポイント制限。毎分 3,000 回、1 日 4,320,000 回も併せて適用されます。
TikTok が返すステータスとリターンコード(40100 などの 4xxxx を含む)。成功を示すのはコード 0 のみです。
開発者アプリごとの Discovery API エンドポイントのレート制限。
日次の上限がリセットされるタイミング。分単位の上限に達した場合は、代わりに TikTok が 5 分間の待機を求めます。
TikTok API の呼び出しにはどの制限が適用されますか?
Accounts API を 1 回呼び出すごとに、最大 3 つのカウンターが動きます。製品や操作によっては独自のカウントを持つものもあります。TikTok はエンドポイントごとのカウンターを独立して管理するため、あるエンドポイントが制限されても、アプリの他のエンドポイントは応答を続けます:
4 つのアプリレベルでは何が許可されますか?
すべての開発者アプリは Basic から始まります。「My Apps」「App Detail」「Authorization」から理由を添えて申請すると、TikTok は 1 段階ずつレベルを上げます。各レベルは、単一のエンドポイントがアプリから使える量と、Accounts API 呼び出しの合計枠の両方を定めます:
上位レベルにすると Accounts API の枠も増えますか?
増えるのは一度だけです。Basic から Advanced に上げると、Accounts API 全体の枠が毎分 600 回から 1,000 回に増え、Premium と Ultimate でも 1,000 回のままです。一方、毎秒と 1 日あたりのエンドポイント制限は上位レベルで増え続けます。アカウントとエンドポイントごとの毎分 40 回の制限はレベルによって変わりません。そのため、混雑した 1 つのアカウントは、アプリがどのレベルでも、あるエンドポイントで毎分 40 回に制限されます。
多くのアカウントがある場合、制限はどう合算されますか?
アカウントごとの制限はアカウント数に比例して増えますが、アプリの枠は増えません。10 アカウントがそれぞれ /business/comment/list/ に毎分 40 回呼び出せば、合計 400 回です。しかし 20 アカウントが同じことをすると 800 回が必要になり、他のエンドポイントを数える前の時点で、Basic アプリの Accounts API 呼び出しの合計枠である 600 回を超えてしまいます。Basic より上のレベルでは、この共有枠は毎分 1,000 回が上限です。
呼び出しが上限を超えるとどうなりますか?
TikTok はそのエンドポイントを制限します。レート制限ガイドでは、制限された呼び出しのコードを 40100 としています。これは HTTP 200 の応答の本文に含まれます。分単位の上限に達した場合はそのエンドポイントが 5 分間閉じられ、日次の上限に達した場合は UTC の 00:00 に日次カウントがリセットされるまで閉じられます。その間もアプリの他のエンドポイントは応答を続けます。コードでの検出と適切な再試行は、エラー 40100 の扱いに含まれます。
投稿数の上限もレート制限ですか?
いいえ。投稿数の上限は呼び出し回数ではなく投稿数を数えるもので、独立したページがあります。TikTok ではアカウントが /business/video/publish/ を通じて毎分 6 件、1 日 15 件まで投稿でき、同じ上限が /business/photo/publish/ にも適用されます。その上限を超えた投稿は、公開ステータスに spam_risk_too_many_posts が返って失敗します。一方、リクエスト制限は呼び出し自体を拒否します。
どの使い方が制限を最も早く消費しますか?
ポーリングです。公開ステータスやコメント一覧をタイマーで確認すると、変化がなくてもそのエンドポイントのアカウント上限である毎分 40 回を消費します。TikTok の Webhook はこれを置き換えるためにあります。投稿の公開イベントは投稿の各段階を通知し、comment.update は 5 分以内に新しいコメントを通知します。ページ単位で読み取り(1 回あたり 20 件の投稿または 30 件のコメント)、メンションは 1 日 1 回取得すれば、消費は低く抑えられます。
easyCoexistence は TikTok の制限された呼び出しをどう扱いますか?
隠さず、TikTok の応答をそのまま渡します。TikTok が制限する list_social_comments、reply_to_comment、get_tiktok_publish_status などのツール呼び出しは、TikTok のメッセージとともにコード 40100 を示すエラーとして AI に返され、自動では再試行されません。投稿は別の経路をたどります。publish_tiktok_post は、今すぐまたは指定した時刻に、各投稿を easyCoexistence のキューに渡します:
- キューは、HTTP 429 の応答が返ると 5 分、30 分、2 時間後に待機して再試行します。
- TikTok は 40100 を HTTP 200 の応答に含めるため、制限された TikTok への投稿公開は TikTok のメッセージとともに失敗し、「要対応」の下で「再試行」を待ちます。
- キューのステータス確認の 1 回で 40100 が返ると、その投稿も失敗扱いになります。ただし TikTok 側では公開済みの可能性があるため、「再試行」の前にアカウントの最新の投稿を確認してください。
- バックグラウンドで失敗した投稿は、チャンネルごとに 3 時間に 1 回まで、オーナーにメールで通知されます。
easyCoexistence はアカウントごとにどの TikTok 呼び出しを行いますか?
わずかで、これらもご自身の呼び出しと同じようにアカウントの上限に計上されます:
- 約 6 時間ごとに /business/get/ を呼び出し、アカウントが応答するか確認します。
- 投稿ごとに公開の呼び出しを 1 回行い、TikTok が投稿を完了または失敗させるまで、約 20 秒ごとに /business/publish/status/ を呼び出します(最大 2 時間)。
- コメントルールや自動化が有効な場合、新しいトップレベルのコメントごとに /business/comment/list/ を 1 回呼び出して投稿者を読み取り、投稿した返信ごとに 1 回呼び出します。
- ツール呼び出しは、AI またはコードが要求したときだけ行われ、1 回の読み取りは 20 件の投稿または 30 件のコメントです。
よくある間違い
- HTTP ステータスから制限を判定すること。TikTok は 40100 を HTTP 200 で返すため、res.ok や 429 の確認では見逃します。本文のコードを読んでください。
- 1 つの混雑したアカウントのためにアプリのレベルを上げること。アカウントとエンドポイントごとの毎分 40 回はレベルが 4 つのどれでも同じなので、そのアカウントの呼び出しを時間的に分散させてください。
- メンションデータを 1 日に何度も取得すること。TikTok は UTC の 0 時から 7 時の間に 1 回だけ更新し、エンドポイントとアカウントごとに 1 日 1 回の呼び出しを推奨しています。
制限された呼び出しには TikTok のコードとメッセージを返し、各投稿は TikTok が完了または失敗させるまで追跡します。接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
TikTok API のアカウントごとのレート制限はどれくらいですか?
認証済みの TikTok アカウントごとに、Accounts API の各エンドポイントで毎分 40 回のクエリです。これは、開発者アプリ全体の枠(Basic では毎分 600 回、それ以上では 1,000 回)の範囲内で適用されます。
TikTok のレート制限はエンドポイントごとに数えられますか?
はい。TikTok のガイドでは、エンドポイント固有の制限は独立しているとされています。そのため、あるエンドポイントの上限に達しても、他のエンドポイントへの呼び出しは止まりません。
TikTok API のレート制限を上げるにはどうすればよいですか?
My Apps、App Detail、Authorization から理由を添えて申請してください。レベルは Basic から Advanced、Premium、Ultimate へと 1 段階ずつ上がります。
easyCoexistence 経由の呼び出しは TikTok の制限に含まれますか?
はい。接続済みアカウントとそのトークンで実行されるため、そのアカウントの他の呼び出しと同様に、エンドポイントごとの毎分 40 回に計上されます。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日