Adspy
Sign inConnect your AI
api / errors

Partner fair use

HTTP 429, code partner_fair_use.

Updated · API v1

What it means

Partner keys of a client with a fair use policy only: this tenant settled its rolling 48-hour research allowance (scope research), or started its rolling 30-day number of new brand or account collections (scope collections). The answer carries scope and retry_at, the exact time the request fits again.

What to do

Wait until retry_at (also in Retry-After, in seconds). Nothing was charged; free requests, and brands or accounts already collected, keep working.

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/partner-fair-use",
  "title": "Partner fair use",
  "status": 429,
  "detail": "…",
  "code": "partner_fair_use",
  "request_id": "3f5b9c2e-8d41-4a7e-9b0c-6e2d1f4a8c37",
  "instance": "/api/v1/…"
}

Every error type and how to handle them.