Skip to content

Request limits (Rate Limit)

General information

API rate limiting applies per user + URL path pair for N requests within time interval T.

If the limit is exceeded, the server returns 429 (Too Many Requests) with:

json
{ "detail": "Rate limit exceeded" }

Limit parameters

  • Pair: user + URL path
  • Maximum number of requests (N): 10
  • Time interval (T): 60 seconds
  • Unauthenticated requests: not counted

Unblocking

When a block is triggered (Rate limit exceeded), it is lifted automatically only after interval T has passed. Retrying requests before T seconds have elapsed extends the block

Recommendations

  • If you exceed the limit, do not send requests for T + 1 seconds.
  • Use client-side rate limiting.
  • When API limits are exceeded, the response status is 429 "Too Many Requests" with a "Retry-After" header indicating how many seconds to wait before calling the API again.