Core APIs
...
Parameters
Seller Data

Seller Products

4min

Seller Products Parameters

GET /request

The Seller Products Parameters are applicable when making a request with type=seller_products to retrieve seller product listing results for a single seller on Amazon - the seller is specified using either the seller_id and amazon_domain parameters or the url parameter (where the url parameter contains a link to an Amazon seller product listing page). The parameters should be appended as querystring parameters to the Product Data API GET HTTP request.

Seller product listing results are retrieved from the seller product listings page for a single seller on Amazon. You can retrieve the seller_id value for a given seller from other Rainforest requests, such as type=offers requests.

Seller Products Listing Page
Seller Products Listing Page


For example, to request seller product listings for the seller with ID A02211013Q5HP3OMSZC7W on amazon.com the request would be:

HTTP
Curl
Node.js
Python
PHP



Seller Products Parameters

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

Parameter

Required

Description

amazon_domain

optional

The Amazon domain to retrieve seller product listings from for the seller specified in the seller_id parameter. For a full list of supported Amazon domains see Supported Amazon Domains .

Note : If the amazon_domain and seller_id parameters are supplied then the url parameter is ignored.

seller_id

optional

The Amazon Seller ID to retrieve seller product listings for. Used in combination with the amazon_domain parameter.

Note : If the seller_id and amazon_domain parameters are supplied then the url parameter is ignored. Note : Seller IDs can be retrieved from Rainforest API type=offers requests.

refinements

optional

A comma-seperated list of refinement values to filter the seller product results by. These allow you to refine your request by values such as "Reviews rating 4 and over", "price range" and "brand".

Refinement values are returned in the refinements array of each type=seller_products result (if they are displayed). Refinement values are dynamic and change by seller. If you wish to use refinements you should first issue a type=seller_products request without specifying any refinements to retrieve a master list of the avaialble refinements for the given request. You can then cache these refinement values for use on subsequent requests.

For example, to run a type=seller_products request specifying two refinements with values p_85/2470955011 and p_36/2421886011 the value of the refinements parameter would be refinements=p_85/2470955011,p_36/2421886011

  • 

    Document image
    

url

optional

The Amazon seller products listing page URL to retrieve seller products results from.

page

optional

The page of seller products results to retrieve.

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      Seller Products Results

Updated 11 Aug 2024
Did this page help you?