Adspy
Sign inConnect your AI
api / errors

Rate limited

HTTP 429, code rate_limited.

Updated · API v1

What it means

The key sent more requests a minute than its contract allows, or the organization more research reads than its limit (120 reads a minute, or the contract's per-key rate when that is higher), shared by its keys and its MCP connections.

What to do

Wait Retry-After seconds. The RateLimit-* headers on every response show the window.

Retryable: send the same request again after Retry-After when the answer has one, with the same Idempotency-Key for a POST.

The answer

application/problem+json
{
  "type": "https://www.adspy.sh/docs/api/errors/rate-limited",
  "title": "Rate limited",
  "status": 429,
  "detail": "…",
  "code": "rate_limited",
  "request_id": "3f5b9c2e-8d41-4a7e-9b0c-6e2d1f4a8c37",
  "instance": "/api/v1/…"
}

Every error type and how to handle them.