Amazon

Get Amazon Best Sellers

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

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

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.

pagenumber

The page number requested for product results

limitnumber

Optionally limit the products results. Typically between 20-50 results will be available per page if no limit is applied.

categoryIdstring

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.

urlstring

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-KEYstring required

API key for authentication

Response

Returns Amazon best sellers with product information

Changes

No recorded changes to this operation across all 1 revision of this API.