Core APIs
...
Parameters
Deals & Bestsellers

Bestsellers

4min

Bestsellers Parameters

GET /request

The Bestsellers Parameters are applicable when making a request with type=bestsellers to retrieve Bestseller results from an Amazon bestsellers page - the bestsellers page is specified either using the category_id and amazon_domain parameters (where category_id is a Category ID returned from the Categories API, or by using the url parameter. The parameters should be appended as querystring parameters to the Product Data API GET HTTP request.

Note that, if using the url parameter it should be url-encoded.

Bestsellers results are retrieved from the bestsellers listing page on Amazon. Rainforest supports all types of Amazon Bestseller pages, bestsellers, new releases, movers & shakers, most wished for and gift ideas.

Bestsellers Page
Bestsellers Page


For example, to request Bestsellers results for the "Appliances" bestsellers page, using category_id=bestsellers_appliances on amazon_domain=amazon.com , the request would be:

HTTP
Curl
Node.js
Python
PHP



Bestsellers Parameters

The following parameters are available for all requests made when type=bestsellers .

Parameter

Required

Description

category_id

optional

A category ID to retrieve bestsellers results from. You must supply a category_id returned from the Categories API in to the category_id parameter.

amazon_domain

optional

The Amazon domain to retrieve bestsellers results from. For a full list of supported Amazon domains see Supported Amazon Domains .

url

optional

The Amazon Bestsellesr results page URL to retrieve bestsellers results from.

Note : The url parameter should be url-encoded.

Note : Either the url or category_id & amazon_domain parameters can be used.

top_free

optional

Set to true to retrieve the "Top 100 Free" version of the specified Bestsellers category_id or url . See screenshot below for how the Top 100 Paid / Top 100 Free bestsellers for a given category are displayed on the Amazon site.

  • 

    Document image
    

Note: Not every Bestsellers category has a "Top 100 Free" list.

page

optional

The current page of Bestsellers results to retrieve. Inspect the pagination.total_pages property in the Bestsellers results to see how many pages of Bestsellers results are available.

max_page

optional

Use the max_page parameter to get multiple pages of results in one request. The API will automatically paginate through pages and concatenate the results into one response.

See the Pagination docs for more information.



Next Steps      Bestsellers Results

Updated 11 Aug 2024
Did this page help you?