v1 limits

LimitFreeCommunity
Steady state5 requests / minute50 requests / minute
Burst5 requests50 requests
ScopePer API key
Bucket refillYour per-minute allowance, spread evenly across the minute

The bucket starts full, so a quiet key can spend a whole minute's allowance at once; sustained throughput then settles at the steady-state rate for your plan.

When you hit the limit

The response is 429 rate_limited with a Retry-After header giving the number of seconds before the next attempt is allowed.

http
HTTP/1.1 429 Too Many Requests
Content-Type: application/json
Retry-After: 3

{ "error": { "code": "rate_limited", "message": "Slow down." } }

Best practice

  • Honor Retry-After verbatim. Don't retry sooner — you'll just stay banned longer.
  • Cap parallelism on your side; the limit is server-wide per key, not per worker.
  • Burst is for short spikes like backfilling a batch of posts, not for sustained throughput.
Rate limits — Public API