Core APIs
...
Parameters
Specialist Pages

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
True


Brand Store results are retrieved from the brand store page on Amazon.

Brand Store Page
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



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?