GET /api/amazon/categories — Full Category Taxonomy

The /api/amazon/categories endpoint retrieves the full product category taxonomy for any supported Amazon marketplace. Each entry in the response includes a category ID, display name, URL, and a slash-separated breadcrumb path showing where it sits in the hierarchy. Use this endpoint to build category navigation menus, populate filter dropdowns, or discover valid category IDs for use with other endpoints.

Use the category IDs returned by this endpoint with the /api/amazon/search and /api/amazon/category endpoints to filter results to a specific category.

Request

GET https://api.glade.dev/api/amazon/categories

string

default:"US"

The Amazon marketplace whose category taxonomy you want to retrieve. Accepted values: US, UK, CA, DE, FR, IT, ES, AU, IN, MX, BR, JP, PL. Defaults to US when omitted.

Response

A successful response returns data.amazonProductCategoryTaxonomy, an array of category objects covering both top-level departments and nested subcategories.

array

Show amazonProductCategoryTaxonomy[]

string

required

The unique category identifier. Pass this value to the /api/amazon/category or /api/amazon/search endpoints to scope results to this category.

string

required

The human-readable display name of the category.

string

required

The canonical Amazon URL for this category browse page.

A slash-separated string representing the category’s position in the taxonomy hierarchy, e.g. "Electronics > Headphones > Over-Ear Headphones". Top-level categories have a single-segment path.

Example response

{
  "success": true,
  "data": {
    "amazonProductCategoryTaxonomy": [
      {
        "id": "172282",
        "name": "Electronics",
        "url": "https://www.amazon.com/b?node=172282",
        "breadcrumbPath": "Electronics"
      },
      {
        "id": "7141123011",
        "name": "Headphones",
        "url": "https://www.amazon.com/b?node=7141123011",
        "breadcrumbPath": "Electronics > Headphones"
      },
      {
        "id": "3015399011",
        "name": "Over-Ear Headphones",
        "url": "https://www.amazon.com/b?node=3015399011",
        "breadcrumbPath": "Electronics > Headphones > Over-Ear Headphones"
      },
      {
        "id": "1055398",
        "name": "Books",
        "url": "https://www.amazon.com/b?node=1055398",
        "breadcrumbPath": "Books"
      }
    ]
  }
}

Curl example

curl --request GET \
  --url "https://api.glade.dev/api/amazon/categories?domain=US" \
  --header "API-KEY: <your-api-key>"

Error handling

If your request is malformed or your credentials are invalid, the API returns a non-2xx status code with a JSON error body. Always check the success field before iterating over data.

HTTP Status	Meaning
`400`	Bad request — the `domain` value is not a recognized marketplace code.
`401`	Unauthorized — your API key is missing or invalid.
`402`	Payment required — your plan does not cover this endpoint or your quota is exhausted.
`429`	Too many requests — you have exceeded your plan’s rate limit.
`502`	Bad gateway — Amazon returned an unexpected response; retry with exponential back-off.

Example error response

{
  "success": false,
  "errors": [
    {
      "code": 400,
      "message": "Invalid parameter value: domain"
    }
  ]
}

Products

Search & Discovery

Sellers & Categories

GET /api/amazon/categories — Full Category Taxonomy

Request

Response

Example response

Curl example

Error handling

Example error response

​Request

​Response

​Example response

​Curl example

​Error handling

​Example error response

Request

Response

Example response

Curl example

Error handling

Example error response