GET /api/amazon/category — Category Details and Products

The /api/amazon/category endpoint returns the full details of a single Amazon product category — including its subcategories, a paginated list of products, and metadata such as its breadcrumb path. Use this endpoint to power category browse pages, populate product grids, or walk the Amazon category tree by following the subcategories array into deeper levels.

Request

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

string

required

The Amazon category node ID you want to browse. Retrieve valid IDs from the /api/amazon/categories endpoint. For example, 7141123011 corresponds to the Headphones category on amazon.com.

string

default:"US"

The Amazon marketplace to query. Accepted values: US, UK, CA, DE, FR, IT, ES, AU, IN, MX, BR, JP, PL. Defaults to US when omitted.

integer

The page number of product results to return. Must be 1 or greater. Omit to retrieve the first page.

string

The sort order applied to product results. Common values include featured, price-asc-rank, price-desc-rank, review-rank, and date-desc-rank. When omitted, Amazon’s default featured sort is used.

Response

A successful response returns data.amazonProductCategory.

object

Show amazonProductCategory

string

The category node ID matching the categoryId you requested.

string

The human-readable display name of the category.

string

The canonical Amazon URL for this category browse page.

A slash-separated string representing the category’s position in the taxonomy, e.g. "Electronics > Headphones > Over-Ear Headphones".

array

Show subcategories[]

string

Subcategory node ID.

string

Subcategory display name.

string

Canonical Amazon URL for the subcategory.

Full breadcrumb path for the subcategory.

object

Show productResults

array

Show results[]

string

Product title.

string

Canonical Amazon product URL.

string

Amazon Standard Identification Number.

object

Show price

string

Currency symbol, e.g. "$".

number

Numeric price value, e.g. 279.99.

string

ISO 4217 currency code, e.g. "USD".

string

Formatted display string, e.g. "$279.99".

string

URL of the primary product image.

number

Average customer rating (1–5).

integer

Total number of customer ratings.

boolean

Whether the product is eligible for Amazon Prime.

boolean

Whether the listing is a sponsored placement.

object | null

Active coupon object, or null if no coupon is present.

Show coupon

string

Coupon label text, e.g. "Save 15%".

object

Show pageInfo

integer

The page number returned.

integer

Total number of product pages available for this category.

integer

Estimated total number of products in this category.

boolean

Whether a subsequent page exists.

boolean

Whether a previous page exists.

Example response

{
  "success": true,
  "data": {
    "amazonProductCategory": {
      "id": "7141123011",
      "name": "Headphones",
      "url": "https://www.amazon.com/b?node=7141123011",
      "breadcrumbPath": "Electronics > Headphones",
      "subcategories": [
        {
          "id": "3015399011",
          "name": "Over-Ear Headphones",
          "url": "https://www.amazon.com/b?node=3015399011",
          "breadcrumbPath": "Electronics > Headphones > Over-Ear Headphones"
        },
        {
          "id": "2407749011",
          "name": "In-Ear Headphones",
          "url": "https://www.amazon.com/b?node=2407749011",
          "breadcrumbPath": "Electronics > Headphones > In-Ear Headphones"
        },
        {
          "id": "7148333011",
          "name": "On-Ear Headphones",
          "url": "https://www.amazon.com/b?node=7148333011",
          "breadcrumbPath": "Electronics > Headphones > On-Ear Headphones"
        }
      ],
      "productResults": {
        "results": [
          {
            "title": "Sony WH-1000XM5 Wireless Noise Canceling Headphones",
            "url": "https://www.amazon.com/dp/B09XS7JWHH",
            "asin": "B09XS7JWHH",
            "price": {
              "symbol": "$",
              "value": 279.99,
              "currency": "USD",
              "display": "$279.99"
            },
            "mainImageUrl": "https://m.media-amazon.com/images/I/61tMFIz7ykL.jpg",
            "rating": 4.7,
            "ratingsTotal": 34821,
            "isPrime": true,
            "sponsored": false,
            "coupon": { "label": "Save 15%" }
          },
          {
            "title": "Bose QuietComfort 45 Bluetooth Wireless Headphones",
            "url": "https://www.amazon.com/dp/B098FKXT8L",
            "asin": "B098FKXT8L",
            "price": {
              "symbol": "$",
              "value": 249.00,
              "currency": "USD",
              "display": "$249.00"
            },
            "mainImageUrl": "https://m.media-amazon.com/images/I/51fSMVNl9JL.jpg",
            "rating": 4.6,
            "ratingsTotal": 28043,
            "isPrime": true,
            "sponsored": false,
            "coupon": null
          }
        ],
        "pageInfo": {
          "currentPage": 1,
          "totalPages": 40,
          "totalResults": 980,
          "hasNextPage": true,
          "hasPrevPage": false
        }
      }
    }
  }
}

Curl example

curl --request GET \
  --url "https://api.glade.dev/api/amazon/category?categoryId=7141123011&domain=US&page=1&sort=review-rank" \
  --header "API-KEY: <your-api-key>"

Error handling

If a required parameter is missing or invalid, the API returns a non-2xx status code with a JSON error body. Always check the success field before reading data.

HTTP Status	Meaning
`400`	Bad request — a required parameter is missing or has an invalid value.
`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": "Missing required parameter: categoryId"
    }
  ]
}

Products

Search & Discovery

Sellers & Categories

GET /api/amazon/category — Category Details and Products

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