GET /api/amazon/bestseller-categories — Category List

The bestseller-categories endpoint returns a flat list of all Amazon best-seller categories available in a given marketplace. Use this endpoint to populate a category picker, build a category browse UI, or discover valid categoryId values to pass to the bestsellers endpoint.

Pass the id from this response as the categoryId parameter in the bestsellers endpoint to retrieve ranked products for that category.

Request

string

default:"US"

The Amazon marketplace to retrieve categories for. Supported values: US, UK, CA, DE, FR, IT, ES, AU, IN, MX, BR, JP, PL. Defaults to US.

Example request

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

Response

A successful response returns data.amazonBestSellerCategories.categories — a flat array of category objects for the requested marketplace.

object

Hide properties

array

Flat list of all available best-seller categories for the marketplace.

Show categories[]

string | null

The category ID. Pass this value as categoryId in the bestsellers endpoint. May be null for top-level aggregate categories that do not have a distinct ID.

string | null

The display name of the category (e.g., "Electronics", "Books"). May be null if unavailable.

string | null

The Amazon best-sellers URL for this category. May be null if unavailable.

Example response

{
  "data": {
    "amazonBestSellerCategories": {
      "categories": [
        {
          "id": "172282",
          "name": "Electronics",
          "url": "https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics/"
        },
        {
          "id": "283155",
          "name": "Books",
          "url": "https://www.amazon.com/Best-Sellers-Books/zgbs/books/"
        },
        {
          "id": "2619525011",
          "name": "Clothing, Shoes & Jewelry",
          "url": "https://www.amazon.com/Best-Sellers-Clothing-Shoes-Jewelry/zgbs/fashion/"
        },
        {
          "id": "1055398",
          "name": "Toys & Games",
          "url": "https://www.amazon.com/Best-Sellers-Toys-Games/zgbs/toys-and-games/"
        },
        {
          "id": "284507",
          "name": "Home & Kitchen",
          "url": "https://www.amazon.com/Best-Sellers-Home-Kitchen/zgbs/home-garden/"
        }
      ]
    }
  }
}

Error handling

This endpoint only accepts a domain query parameter. If you pass an unsupported domain code, the API returns a 400 error. Make sure your API-KEY header is present on every request.

{
  "success": false,
  "errors": [
    {
      "code": "BAD_REQUEST",
      "message": "Invalid domain value. Supported domains: US, UK, CA, DE, FR, IT, ES, AU, IN, MX, BR, JP, PL.",
      "path": "domain"
    }
  ]
}

Status	Meaning
`400`	Invalid or unsupported `domain` value
`401`	Missing or invalid `API-KEY` / Bearer token
`402`	Plan limit reached or payment required
`429`	Rate limit exceeded
`502`	Upstream Amazon error or bad gateway

Products

Search & Discovery

Sellers & Categories

GET /api/amazon/bestseller-categories — Category List

Request

Example request

Response

Example response

Error handling

​Request

​Example request

​Response

​Example response

​Error handling

Request

Example request

Response

Example response

Error handling