Core APIs
...
Results
Specialist Pages

Brand Stores

3min

Store Results

When making a request with the type parameter set to type=store Rainforest API will return 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 results are retrieved from the brand store page on Amazon.

Brand Store Page
Brand Store Page


An example of the JSON object returned from a Brand Store request is shown below:

JSON


Editorial Results Store result pages can have different layouts and are not always a standard list of ASIN results. If a store_result has the type=editorial then the ASIN is being displayed as a graphic/creative, instead of a regular ASIN product listing. In this instance the title field is not available (as the text of the product title is shown in the creative image instead) and a editorial_image field containing the creative image is returned.

Rainforest API returns the following properties for Brand Store requests:

Property

Type

Description

store_info

object

An object containing details of the Brand Store.

  • name
  • string
  • The name of the Brand Store, if shown.



  • description
  • string
  • The description of the Brand Store, if shown.



  • logo
  • object
  • An object containing link and title properties being the image URL link to the Brand Store logo, and the title associated with the logo image.



  • hero_image
  • object
  • An object containing a link property being a link to the hero (banner) image URL, if shown on the Brand Store page.

store_results

array

An array containing details of the products shown on the Brand Store page. Each object in the array contains the following properties:

  • title
  • string
  • The title of the product, not available when type=editorial



  • link
  • string
  • The link to the product page.



  • asin
  • string
  • The ASIN of the product.



  • image
  • string
  • A link to the image of the product.



  • rating
  • number
  • The overall rating of the product, out of 5.



  • ratings_total
  • number
  • The total number of customer ratings the product has received.



  • price
  • object
  • A price object describing the price of the product.



  • type
  • number
  • Set to editorial in the case of the ASIN result being shown as an "editorial" result (where the ASIN is described in a creative image, instead of a regular ASIN list) or regular in the case of the ASIN result being shown in a regular list.



  • editorial_image
  • number
  • Returned when type=editorial (if available) and contains a link to the creative image for the ASIN result.

categories

array

An array containing details of the categories shown on the Brand Store page. Each object in the array contains the following properties:

  • name
  • string
  • The name of the category (i.e. "Toys & Games").



  • link
  • string
  • The link to the Brand Store page category.



  • is_current
  • boolean
  • Set to true when the Brand Store category is the currently displayed one.

pagination

object

An object containing details of the current Brand Store page and the total number of pages that are available.

  • current_page
  • number
  • The current page number.



  • total_pages
  • number
  • The total number of pages available.


Next Steps      Store Parameters

Updated 11 Aug 2024
Did this page help you?