GET /api/amazon/bestsellers — Best Sellers by Category

The bestsellers endpoint returns the current Amazon best-seller list for a given category, along with each product’s rank, price, rating, and Prime eligibility. The response also includes full category hierarchy — parent category, current category breadcrumb, and child categories — so you can build navigable category trees in your application.

Use the bestseller-categories endpoint to discover valid categoryId values for the marketplace you’re querying.

Request

string

default:"US"

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

string

The Amazon best-seller category ID to retrieve rankings for. You can obtain valid IDs from the bestseller-categories endpoint. Either categoryId or url must be provided.

string

A direct Amazon best-sellers page URL (e.g., https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics/). Use this as an alternative to categoryId when you have a URL on hand.

integer

Page number to retrieve. Minimum value: 1.

integer

Number of products to return per page. Minimum value: 1.

Example request

curl "https://api.glade.dev/api/amazon/bestsellers?domain=US&categoryId=172282" \
  -H "API-KEY: YOUR_API_KEY"

Response

A successful response returns data.amazonBestSellers with ranked product results and full category context.

object

Hide properties

object

Show properties

array

Ranked array of best-seller product objects, ordered by bestSellersRank ascending.

Show results[]

string

Full product title as shown on Amazon.

string

Canonical Amazon product page URL.

string

Amazon Standard Identification Number for the product. Matches the pattern ^[A-Z0-9]{10}$.

object

Show properties

string

Currency symbol (e.g., "$").

number

Numeric price value.

string

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

string

Human-readable price string (e.g., "$29.99").

string

URL of the product’s primary image.

number

Average customer rating out of 5.

integer

Total number of customer ratings.

boolean

true if the product is eligible for Amazon Prime shipping.

integer

The product’s numeric rank within this best-seller category (e.g., 1 is the top seller). Always greater than 0.

object

Show properties

integer

The current page number returned.

integer

Total number of pages available for this category.

integer

Total number of best-seller products in this category.

boolean

true if there is a subsequent page of results.

boolean

true if there is a previous page of results.

object

Hierarchical category context for the requested best-seller list.

Show properties

object

The category you requested.

Show properties

string

Category ID.

string

Display name of the category.

string

Amazon URL for this category’s best-seller page.

Ordered array of ancestor category names forming a breadcrumb trail from root to current category.

object | null

The immediate parent category, or null if the requested category is a top-level category.

Show properties

string

Parent category ID.

string

Parent category name.

string

Amazon URL for the parent category’s best-seller page.

Ordered array of ancestor category names forming a breadcrumb trail for the parent category.

array

Array of subcategories beneath the current category. Empty array if no subcategories exist.

Show childCategories[]

string

Child category ID.

string

Child category name.

string

Amazon URL for the child category’s best-seller page.

Example response

{
  "data": {
    "amazonBestSellers": {
      "productResults": {
        "results": [
          {
            "title": "Fire TV Stick 4K Max Streaming Device, Wi-Fi 6E, Alexa Voice Remote",
            "url": "https://www.amazon.com/dp/B0BP9SNVH9",
            "asin": "B0BP9SNVH9",
            "price": {
              "symbol": "$",
              "value": 59.99,
              "currency": "USD",
              "display": "$59.99"
            },
            "mainImageUrl": "https://m.media-amazon.com/images/I/61HnD3KNEAL._AC_SL1000_.jpg",
            "rating": 4.6,
            "ratingsTotal": 87423,
            "isPrime": true,
            "bestSellersRank": 1
          },
          {
            "title": "Echo Pop — Full Sound Compact Smart Speaker with Alexa",
            "url": "https://www.amazon.com/dp/B09WX9XMJP",
            "asin": "B09WX9XMJP",
            "price": {
              "symbol": "$",
              "value": 39.99,
              "currency": "USD",
              "display": "$39.99"
            },
            "mainImageUrl": "https://m.media-amazon.com/images/I/61aFLfqiLgL._AC_SL1000_.jpg",
            "rating": 4.5,
            "ratingsTotal": 42318,
            "isPrime": true,
            "bestSellersRank": 2
          },
          {
            "title": "Kindle Paperwhite (16 GB) — Now with 3 months free Kindle Unlimited",
            "url": "https://www.amazon.com/dp/B09TMF6742",
            "asin": "B09TMF6742",
            "price": {
              "symbol": "$",
              "value": 139.99,
              "currency": "USD",
              "display": "$139.99"
            },
            "mainImageUrl": "https://m.media-amazon.com/images/I/61MFsTyFmoL._AC_SL1000_.jpg",
            "rating": 4.7,
            "ratingsTotal": 115060,
            "isPrime": true,
            "bestSellersRank": 3
          }
        ],
        "pageInfo": {
          "currentPage": 1,
          "totalPages": 5,
          "totalResults": 100,
          "hasNextPage": true,
          "hasPrevPage": false
        }
      },
      "categoryInfo": {
        "currentCategory": {
          "id": "172282",
          "name": "Electronics",
          "url": "https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics/",
          "breadcrumbPath": ["Best Sellers", "Electronics"]
        },
        "parentCategory": null,
        "childCategories": [
          {
            "id": "16225009011",
            "name": "Camera & Photo",
            "url": "https://www.amazon.com/Best-Sellers-Camera-Photo/zgbs/electronics/502394/"
          },
          {
            "id": "1266092011",
            "name": "Computers & Accessories",
            "url": "https://www.amazon.com/Best-Sellers-Computers-Accessories/zgbs/electronics/541966/"
          },
          {
            "id": "11091801",
            "name": "Headphones",
            "url": "https://www.amazon.com/Best-Sellers-Electronics-Headphones/zgbs/electronics/745526/"
          }
        ]
      }
    }
  }
}

Error handling

You must supply either a categoryId or a url parameter. Providing neither, or supplying a categoryId that does not exist in the selected marketplace, returns a 400 error.

{
  "success": false,
  "errors": [
    {
      "code": "BAD_REQUEST",
      "message": "Either 'categoryId' or 'url' is required."
    }
  ]
}

Status	Meaning
`400`	Missing or invalid query parameters
`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/bestsellers — Best Sellers by Category

Request

Example request

Response

Example response

Error handling

​Request

​Example request

​Response

​Example response

​Error handling

Request

Example request

Response

Example response

Error handling