Rate limits

Each API key is limited to 2 requests per second and each source IP is limited to 20 requests per second across keys. Partner and Creator API surfaces have separate IP buckets. For IPv6 callers, addresses in the same /56 subnet share an IP bucket. Successful responses describe the per-key budget:

Header	Example	Meaning
`RateLimit`	`limit=2, remaining=1, reset=1`	Limit, remaining requests, and seconds until reset.
`RateLimit-Policy`	`2;w=1`	Two requests per one-second window.

A limited request returns 429 and a Retry-After header:

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "This API key is over its rate limit. Wait for Retry-After before sending more.",
    "details": { "limit": 2, "windowSeconds": 1 }
  }
}

Wait for Retry-After, add jitter when many workers share a key, and avoid concurrent retry loops. The IP cap can be reached even if every individual key remains below its own limit.

Overview

Core concepts