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
﻿
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
https://api.rainforestapi.com/request?api_key=demo&type=seller_products&seller_id=A02211013Q5HP3OMSZC7W&amazon_domain=amazon.com
https://api.rainforestapi.com/request?api_key=demo&type=seller_products&seller_id=A02211013Q5HP3OMSZC7W&amazon_domain=amazon.com
﻿
﻿
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
﻿
﻿
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﻿

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
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.

Updated 11 Aug 2024

Did this page help you?

Seller Feedback

Author Page