bestseller-categories

Authentication and cost

Send a reveal-once key with API-KEY or Authorization: Bearer. One successful normalized response consumes one unit. Validation, authentication, rate, quota, provider, timeout, and internal failures consume zero.

Parameters

Runnable request

curl "https://api.glade.dev/api/amazon/bestseller-categories?domain=US" \
  -H "API-KEY: glade_test_lookup_your_secret"

Response and freshness

The canonical payload is returned under data.amazonBestSellerCategories. The current policy TTL is 1 days; response headers report the cache decision, fetched time, request ID, and unit cost. Location-sensitive values use the documented default delivery context for the selected marketplace.

{
  "data": {
    "amazonBestSellerCategories": {
      "...": "See the generated OpenAPI schema"
    }
  }
}

Errors and edge cases

• 400 / 7001 — invalid or mutually inconsistent input.
• 401 / 7003 — missing, malformed, expired, revoked, or CIDR-restricted key.
• 403 / 7403 — scope, plan, organization, or interface is not enabled.
• 429 — atomic rate, concurrency, or quota decision rejected the request.
• 502/503/504 — provider, schema, circuit, or timeout failure; zero units.