Developer Docs
Rate limits & Credits
Per-key sliding-window limits and the prepaid credit currency.
Two independent controls govern usage: a rate limit (how fast) and credits (how much). They fail differently, so handle them differently.
Rate limits
Each key gets a per-second sliding window sized by your plan. Over the limit returns 429 rate_limit_exceeded; every response carries the window state in X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset. Back off and retry — the limit is transient.
| Plan | Requests / 1s (default) |
|---|---|
| Free | 1 |
| Starter | 5 |
| Pro | 20 |
| Scale / Enterprise | 100 |
These are the current defaults; a plan may raise them.
Credits
Every billable request spends prepaid credits by SKU. Running out returns 402 insufficient_credits — retrying will not help; top up. Check your balance and per-key spend at GET /v1/usage, and your allotment at GET /v1/entitlements.
| Operation | Credits | When it applies |
|---|---|---|
cached-read | 1 | A read served from our store — the common case for every dataset. |
live-refresh | 25 | You asked us to refresh a creator's LIVE state from TikTok now. |
profile-resolve | 25 | An on-demand profile fetch from TikTok for an account we hold nothing fresh for (R4.1). |
comments-collect | 10 | An on-demand video-comment page collected from TikTok (R4.3). |
follow-list-resolve | 75 | An on-demand follower/following list walk — many signed, rate-limited pages (R4.5). |
export | 50 | A bulk dataset export job. |
room-minute | 1 | Each completed minute a realtime subscription owns a LIVE room. |
A store hit is always cached-read; only requests that touch TikTok cost more.