Log inStart Free Trial
easyCoexistence Official APIs

TikTok error 40100: requests made too frequently

TikTok error 40100 means a rate limit throttled the request: TikTok answers with code 40100 in the body of an HTTP 200 response, so the status alone does not show it. The fix is to pause calls to that endpoint, 5 minutes after a per-minute limit or until 00:00 UTC after a daily one, then send fewer, larger requests.

easyCoexistence returns TikTok's code and message to Claude, ChatGPT or your own code, so your AI can tell a rate limit from a failed post and wait before trying again.

40100

The code TikTok returns once a rate limit is met, meaning the request was throttled.

HTTP 200

The status TikTok sends with its return codes, 40100 included; only code 0 in the body means success.

40 QPM

The Accounts API rate limit for each authorized TikTok account on each endpoint.

600 QPM

All Accounts API endpoints combined, per developer app at the Basic level; higher levels allow 1,000.

5 minutes

How long TikTok says to wait before calling again after reaching a per-minute limit.

15 a day

The most video posts an account can publish through the API in a day, at six a minute at most.

What does error 40100 mean?

A rate limit stopped the request. TikTok's return code appendix describes 40100 as requests made too frequently, because the endpoint's limit at the developer app level has been reached, and its rate limits guide says the server returns 40100 once a limit is met. Calls to that endpoint have to pause until the suspension lifts.

How do you detect 40100 in code?

By the code in the body, not the HTTP status. TikTok sends its return codes with HTTP 200, so check code on each answer: 0 means success and 40100 a throttled request. A 4xx status points to a wrong path or method, and on a 5xx TikTok advises waiting about 5 minutes before retrying:

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 };
}

Which limits can return 40100?

TikTok's rate limits guide says the server returns 40100 once a rate limit is met, and each limit is counted separately, with the full figures by app level on the rate limits page. An Accounts API call counts against three:

  • 40 queries a minute for each authorized account on each Accounts API endpoint, the same at every app level.
  • 600 queries a minute across the Accounts API per developer app at Basic, and 1,000 above it.
  • Per-endpoint app limits by second, minute and day, set by the app's level.

How long should you wait?

That depends on which limit was reached. After a per-minute limit, TikTok says to wait 5 minutes before calling again. After a daily limit, wait until the next day, since daily limits reset at 00:00:00 UTC. TikTok's guide adds that endpoint-specific limits are independent, so reaching one endpoint's limit does not stop calls to another.

Is the cap of 15 posts a day the same limit?

No. The publishing cap counts posts, six a minute and 15 a day per account on each publishing endpoint, and a post past it fails in its publishing status with spam_risk_too_many_posts rather than with 40100. TikTok's advice for that failure is to publish the post from the TikTok mobile app, and the posting limits page covers it.

How do you stay under the limits?

TikTok's advice is to make fewer, larger requests and to cap how many run at once. On the Accounts API that means reading up to 20 posts per /business/video/list/ page and up to 30 comments per /business/comment/list/ page instead of fetching them one at a time, spacing calls with a token bucket, or queueing them so a fixed number of workers send them and failed tasks return to the queue after a delay.

Will a higher app level stop 40100?

Only when an app limit was the one reached. Every app starts at Basic, and TikTok raises it one level at a time, from Basic to Advanced, then Premium and Ultimate, on a request made under My Apps, App Detail, Authorization that gives a reason. TikTok's Accounts API guide states the limit of 40 a minute per account and endpoint as a single figure, separate from the app's level, so one busy account is fixed by spacing its calls.

Common mistakes

  • Retrying at once. The endpoint stays throttled until the suspension lifts, so quick retries spend calls without getting through.
  • Fetching posts or comments one at a time. A list call returns a page of up to 20 posts or 30 comments, and each call counts toward the 40 a minute.
  • Polling the publishing status in a tight loop. Every check is a call to /business/publish/status/, and post IDs can take up to three minutes to appear, so space the checks.
  • Treating spam_risk_too_many_posts as a rate limit. It counts posts created through the API over the last 24 hours, not calls per minute, so slowing the calls down does not address it.
Doing this with EasyCoexistence

Its tools read comments 30 to a page and posts up to 20 at a time, and publish_tiktok_post tells the AI up front that TikTok caps API posting at about 15 posts a day per account. US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

Does TikTok return HTTP 429 when a call is rate limited?

TikTok's guides describe a throttled call as code 40100 in the body of an HTTP 200 answer, and name no 429 status, so check the code field on each response.

How long does a TikTok 40100 throttle last?

TikTok says to wait 5 minutes after a per-minute limit is reached. A daily limit lifts at 00:00:00 UTC, when it resets.

Does easyCoexistence retry a call that returns 40100?

Not on its own. A throttled tool call comes back to your AI with code 40100 and TikTok's message, and a throttled post in the queue fails with that message and waits under Needs attention until you choose Retry.

Is 40100 different from 40016?

TikTok's appendix gives both the same description, requests made too frequently at the developer app level, and the same fix: check the rate limits guide. 40133 covers the advertiser level.

Keep reading

Connect your first channel in two minutes.

No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.

  • 3 days free
  • Cancel any time
  • Official APIs only
  • Monitored 24/7

Verified on