TikTok Ads Limits
Rate Headers
| Header | Meaning |
|---|---|
x-ratelimit-remaining | Countdown of remaining requests (no total) |
x-ratelimit-reset | Seconds until the sliding window clears |
The limiter is per-advertiser. Calls without an advertiser_id (token refresh, listing) go against the app-level key.
Throttle Codes (Often with HTTP 200)
| Code | Meaning |
|---|---|
20001 | Rate limit exceeded |
20002 | Daily quota exhausted |
20003 | Concurrent request limit |
A genuine HTTP 429 is also possible.
Backoff in LightLead
- Priority:
x-ratelimit-reset(sec → ms, capped at 15 min) - Fallback:
60s * 2^attempt, max 15 min - If a block is active — an error with the time until retry
Metrics
Only the keys from mapTikTokMetricIds are requested (see Metrics).