Brand Stores

4min

Store Parameters
﻿GET  /request
The Store parameters are applicable when making a request with  type=store  to retrieve Brand Store results for a Brand Store. The Brand Store can be specified either by the  url  parameter, or by a combination of the  store_id  and  amazon_domain  parameters. The parameters should be appended as querystring parameters to the Product Data API GET HTTP request.
Brand Store IDs and URLs
Brand Store IDs and URLs are returned by  type=product  product page requests under the  brand_store.id  and  brand_store.url  properties assuming they are shown on the product page. The Brand Store ID/URL is typically shown above the ASIN title, as shown below:
True
﻿
Brand Store results are retrieved from the brand store page on Amazon.
Brand Store Page
﻿
For example, to request Brand Store results for the Store ID  70F3122D-4966-4242-A8A6-871C8D7E6F8B  on  amazon.com , the request would be:
HTTP
Curl
Node.js
Python
PHP
https://api.rainforestapi.com/request?api_key=demo&type=store&store_id=70F3122D-4966-4242-A8A6-871C8D7E6F8B&amazon_domain=amazon.com
https://api.rainforestapi.com/request?api_key=demo&type=store&store_id=70F3122D-4966-4242-A8A6-871C8D7E6F8B&amazon_domain=amazon.com
﻿
﻿
Store Parameters
The following parameters are available for all requests made when  type=store .
Parameter
Required
Description
store_id
optional
A Brand Store ID to retrieve results from. Should be used in combination with the amazon_domain parameter.  
Note if the url parameter is supplied then the store_id parameter is ignored as the url itself specifies the store ID.
amazon_domain
optional
The Amazon domain to retrieve Brand Store results from. For a full list of supported Amazon domains see Supported Amazon Domains . Should be used in combination with the store_id parameter.  
Note if the url parameter is supplied then the amazon_domain parameter is ignored as the url itself specifies the Amazon domain.
url
optional
The Brand Store page URL to retrieve Brand Store results from. Be sure to URL-encode the url parameter.  
Note the url parameter is supplied, the store_id and amazon_domain parameters cannot be used (as the url itself defines the Store ID and Amazon domain used).
page
optional
The current page of Brand Store 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
     Store Results﻿

Updated 11 Aug 2024

Did this page help you?

Author Page

Charts

Parameter	Required	Description
store_id	optional	A Brand Store ID to retrieve results from. Should be used in combination with the amazon_domain parameter. Note if the url parameter is supplied then the store_id parameter is ignored as the url itself specifies the store ID.
amazon_domain	optional	The Amazon domain to retrieve Brand Store results from. For a full list of supported Amazon domains see Supported Amazon Domains . Should be used in combination with the store_id parameter. Note if the url parameter is supplied then the amazon_domain parameter is ignored as the url itself specifies the Amazon domain.
url	optional	The Brand Store page URL to retrieve Brand Store results from. Be sure to URL-encode the url parameter. Note the url parameter is supplied, the store_id and amazon_domain parameters cannot be used (as the url itself defines the Store ID and Amazon domain used).
page	optional	The current page of Brand Store 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.