---
title: "Best sellers"
method: GET
path: "/api/amazon/bestsellers"
---

# Best sellers

`GET /api/amazon/bestsellers`

## Request

- Base URL: `https://gladeapi.com`
- URL: `https://gladeapi.com/api/amazon/bestsellers`
- Auth: one of:
  - API key in header `API-KEY`
  - HTTP bearer

Get ranked best sellers using exactly one category ID or Amazon URL.

## Query parameters

- `domain` 'US' | 'UK' | 'CA' | 'DE' | 'FR' | 'IT' | 'ES' | 'AU' | 'IN' | 'MX' | 'BR' | 'JP' | 'PL'
- `categoryId` string
- `url` string, uri
- `page` integer
- `limit` integer

## Response `200`

Successful Amazon data response

- object
  - `data` object, required
    - `amazonBestSellers` object, required
      - `productResults` object
        - `results` object[]
          - `title` string
          - `url` string
          - `asin` string
          - `price` object
            - `symbol` string
            - `value` number
            - `currency` string
            - `display` string
          - `mainImageUrl` string
          - `rating` number
          - `ratingsTotal` integer
          - `isPrime` boolean
          - `bestSellersRank` integer
        - `pageInfo` object
          - `currentPage` integer
          - `totalPages` integer
          - `totalResults` integer
          - `hasNextPage` boolean
          - `hasPrevPage` boolean
      - `categoryInfo` object
        - `currentCategory` object
          - `id` string
          - `name` string
          - `url` string
          - `breadcrumbPath` string
        - `parentCategory` object, nullable
          - `id` string
          - `name` string
          - `url` string
          - `breadcrumbPath` string
        - `childCategories` object[]
          - `id` string
          - `name` string
          - `url` string
          - `breadcrumbPath` string

## Other responses

- `400`: Standard error response
- `401`: Standard error response
- `402`: Standard error response
- `403`: Standard error response
- `404`: Standard error response
- `429`: Standard error response
- `500`: Standard error response
- `502`: Standard error response
- `503`: Standard error response
- `504`: Standard error response

---

[API](https://skmtc.dev/gladeapi/apis/glade-amazon-api.md) · [All operations](https://skmtc.dev/gladeapi/apis/glade-amazon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gladeapi/apis/glade-amazon-api/revisions/69f6e664510f?raw)