---
title: "Get Amazon Best Sellers"
method: GET
path: "/api/amazon/bestsellers"
tags: ["Amazon"]
---

# Get Amazon Best Sellers

`GET /api/amazon/bestsellers`

## Request

- Base URL: `https://rest.canopyapi.co`
- URL: `https://rest.canopyapi.co/api/amazon/bestsellers`
- Auth: API key in header `API-KEY`

Retrieve Amazon Best Sellers rankings. Returns a paginated list of top-ranked products by category, including rank position, ratings, and category navigation information.

## Query parameters

- `domain` 'US' | 'UK' | 'CA' | 'DE' | 'FR' | 'IT' | 'ES' | 'AU' | 'IN' | 'MX' | 'BR' | 'JP' | 'PL' | 'AE' | 'SG' | 'NL' | 'SE': The domain for fetching best sellers data, defaults to US.
- `page` number: The page number requested for product results
- `limit` number: Optionally limit the products results. Typically between 20-50 results will be available per page if no limit is applied.
- `categoryId` string: A bestseller category slug (e.g. bestsellers_electronics), required if url is not provided. Discover slugs via the Bestseller Categories endpoint. Slugs are marketplace-specific — fetch them separately for each domain; they are not interchangeable with the numeric IDs used by the Category or Search endpoints.
- `url` string: The Amazon URL of a best sellers page (required if categoryId is not provided), e.g. a url returned by the Bestseller Categories endpoint. The URL determines the marketplace, so the domain parameter is ignored when url is used.

## Headers

- `API-KEY` string, required: API key for authentication

## Response `200`

Returns Amazon best sellers with product information

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

## Other responses

- `400`: Input Validation Error
- `401`: Unauthorized
- `500`: Internal Server Error - request failed

---

[API](https://skmtc.dev/canopyapi/apis/canopy-api-rest-endpoints.md) · [All operations](https://skmtc.dev/canopyapi/apis/canopy-api-rest-endpoints/llms.txt) · [OpenAPI document](https://skmtc.dev/canopyapi/apis/canopy-api-rest-endpoints/revisions/dc3281f521e7?raw)