Brand Stores

3 min

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

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

{
  "request_info": {
    "success": true,
    "credits_used": 1,
    "credits_remaining": 999
  },
  "request_metadata": {
    "id": "130fc2e6a878ee40070c093a678b135b4a3eee7b",
    "created_at": "2020-01-01T00:00:00.000Z",
    "processed_at": "2020-01-01T00:00:00.001Z",
    "total_time_taken": 0.1,
    "amazon_url": "https://www.amazon.com/stores/page/70F3122D-4966-4242-A8A6-871C8D7E6F8B"
  },
  "request_parameters": {
    "type": "store",
    "amazon_domain": "amazon.com",
    "store_id": "70F3122D-4966-4242-A8A6-871C8D7E6F8B",
    "page": "1"
  },
  "store_info": {
    "name": "Swarovski",
    "description": "Swarovski, all assortment",
    "logo": {
      "link": "https://m.media-amazon.com/images/S/stores-image-uploads-na-prod/5/AmazonStores/ATVPDKIKX0DER/db964e91c4fcc95c61f2f5f651bbdeba.w400.h400._CR0%2C0%2C400%2C400_SX100_.jpg",
      "title": "Swarovski Logo"
    },
    "hero_image": {
      "link": "https://m.media-amazon.com/images/S/stores-image-uploads-na-prod/7/AmazonStores/ATVPDKIKX0DER/76b4e3a99106243e832f769e7bb52601.w3000.h600._CR0%2C0%2C3000%2C600_SX1500_.png"
    }
  },
  "store_results": [
    {
      "asin": "B074TXGWM1",
      "title": "SWAROVSKI Women's Iconic Swan Jewelry Collection, Rose Gold Tone Finish, Black Crystals",
      "link": "https://www.amazon.com/Swarovski-Facet-Swan-Necklace-5281275/dp/B074TXGWM1",
      "rating": 4.7,
      "ratings_total": 1450,
      "type": "regular",
      "price": {
        "symbol": "$",
        "value": 91.13,
        "currency": "USD",
        "raw": "$91.13"
      }
    },
    {
      "asin": "B00SJEO2QC",
      "type": "editorial",
      "editorial_image": "https://m.media-amazon.com/images/S/stores-image-uploads-na-prod/a/AmazonStores/ATVPDKIKX0DER/944223446231d8278fc688037a470269.w2000.h2000._CR0%2C0%2C2000%2C2000_SX750_SY750_.jpg",
      "link": "https://www.amazon.com/Swarovski-Angelic-All-Around-Necklace-5117703/dp/B00SJEO2QC",
      "price": {
        "symbol": "$",
        "value": 186.13,
        "currency": "USD",
        "raw": "$186.13"
      }
    },
    {
      "asin": "B0734MSVB1",
      "title": "SWAROVSKI Women's Angelic Crystal Jewelry Collection",
      "link": "https://www.amazon.com/Swarovski-Crystal-Gold-Plated-Angelic-Necklace/dp/B0734MSVB1",
      "rating": 4.6,
      "ratings_total": 602,
      "price": {
        "symbol": "$",
        "value": 229,
        "currency": "USD",
        "raw": "$229"
      }
    },
    {
      "asin": "B088MFP9MQ",
      "title": "SWAROVSKI Women's Angelic Rectangular Jewelry Collection, Rhodium Finish, Green Crystals, Clear Crystals",
      "link": "https://www.amazon.com/SWAROVSKI-Angelic-Necklace-Rectangular-Crystal/dp/B088MFP9MQ",
      "rating": 4.6,
      "ratings_total": 217,
      "type": "regular",
      "price": {
        "symbol": "$",
        "value": 71.2,
        "currency": "USD",
        "raw": "$71.2"
      }
    },
    {
      "asin": "B08836YV2K",
      "title": "SWAROVSKI Angelic Pendant with Circular Clear Crystal and Clear Crystal Pavé on a Rhodium Plated Chain",
      "link": "https://www.amazon.com/SWAROVSKI-Angelic-Pendant-Circular-Crystal/dp/B08836YV2K",
      "rating": 4.7,
      "ratings_total": 338,
      "type": "regular",
      "price": {
        "symbol": "$",
        "value": 73.14,
        "currency": "USD",
        "raw": "$73.14"
      }
    },
    {
      "asin": "B010LXAAX2",
      "title": "SWAROVSKI Women's Angelic Jewelry Collection, Rhodium Finish, Blue Crystals, Clear Crystals",
      "link": "https://www.amazon.com/Attract-Earrings-White-Rhodium-plated/dp/B010LXAAX2",
      "rating": 4.7,
      "ratings_total": 1541,
      "type": "regular",
      "price": {
        "symbol": "$",
        "value": 89,
        "currency": "USD",
        "raw": "$89"
      }
    },
    {
      "asin": "B07RDMK1YV",
      "title": "SWAROVSKI Women's Angelic Jewelry Collection, Rhodium Finish, Blue Crystals, Clear Crystals",
      "link": "https://www.amazon.com/Angelic-Pierced-Earrings-Rhodium-plated/dp/B07RDMK1YV"
    },
    {
      "asin": "B07TYTDD4Y",
      "title": "SWAROVSKI Women's Angelic Crystal Jewelry Collection",
      "link": "https://www.amazon.com/Angelic-SWAROVSKI-5505470-womens-earrings/dp/B07TYTDD4Y",
      "rating": 4.6,
      "ratings_total": 602,
      "price": {
        "symbol": "$",
        "value": 71.95,
        "currency": "USD",
        "raw": "$71.95"
      }
    },
    {
      "asin": "B004X0HPBU",
      "title": "SWAROVSKI Women's Angelic Jewelry Collection, Rhodium Finish, Blue Crystals, Clear Crystals",
      "link": "https://www.amazon.com/Swarovski-1081942-Angelic-Pierced-Earrings/dp/B004X0HPBU",
      "rating": 4.7,
      "ratings_total": 1541,
      "price": {
        "symbol": "$",
        "value": 51.87,
        "currency": "USD",
        "raw": "$51.87"
      }
    },
    {
      "asin": "B0883CDFDB",
      "title": "Swarovski Women's Crystal Jewelry Sets, Necklace and Earring Collection",
      "link": "https://www.amazon.com/SWAROVSKI-Angelic-Pendant-Necklace-Crystals/dp/B0883CDFDB",
      "rating": 4.6,
      "ratings_total": 603,
      "price": {
        "symbol": "$",
        "value": 149,
        "currency": "USD",
        "raw": "$149"
      }
    },
    {
      "asin": "B01KP0VO4A",
      "title": "SWAROVSKI Women's Angelic Crystal Jewelry Collection",
      "link": "https://www.amazon.com/Swarovski-5240513-Angelic-Bracelet/dp/B01KP0VO4A",
      "rating": 4.6,
      "ratings_total": 602,
      "price": {
        "symbol": "$",
        "value": 130.13,
        "currency": "USD",
        "raw": "$130.13"
      }
    },
    {
      "asin": "B00P9L2NVO",
      "title": "SWAROVSKI Women's Angelic Jewelry Collection, Rhodium Finish, Blue Crystals, Clear Crystals",
      "link": "https://www.amazon.com/Swarovski-5071173-Angelic-Bracelet/dp/B00P9L2NVO",
      "rating": 4.7,
      "ratings_total": 1541,
      "price": {
        "symbol": "$",
        "value": 115.09,
        "currency": "USD",
        "raw": "$115.09"
      }
    },
    {
      "asin": "B07TWP47C1",
      "title": "SWAROVSKI Women's Angelic Crystal Jewelry Collection",
      "link": "https://www.amazon.com/SWAROVSKI-Bracelet-5505469-Angelic-Cristal/dp/B07TWP47C1",
      "rating": 4.6,
      "ratings_total": 602,
      "price": {
        "symbol": "$",
        "value": 130.13,
        "currency": "USD",
        "raw": "$130.13"
      }
    },
    {
      "asin": "B088MFL96F",
      "title": "SWAROVSKI Women's Angelic Rectangular Jewelry Collection, Rhodium Finish, Green Crystals, Clear Crystals",
      "link": "https://www.amazon.com/SWAROVSKI-Angelic-Bracelet-Crystals-Adjustable/dp/B088MFL96F",
      "rating": 4.6,
      "ratings_total": 217,
      "price": {
        "symbol": "$",
        "value": 63.2,
        "currency": "USD",
        "raw": "$63.2"
      }
    },
    {
      "asin": "B08CKCQZXB",
      "title": "SWAROVSKI Women's Angelic Jewelry Collection, Rhodium Finish, Blue Crystals, Clear Crystals",
      "link": "https://www.amazon.com/SWAROVSKI-Angelic-Cushion-Bracelet-Rhodium/dp/B08CKCQZXB",
      "rating": 4.7,
      "ratings_total": 1541,
      "price": {
        "symbol": "$",
        "value": 79,
        "currency": "USD",
        "raw": "$79"
      }
    },
    {
      "asin": "B08834QLPC",
      "title": "SWAROVSKI Angelic Pendant with Circular Clear Crystal and Clear Crystal Pavé on a Rhodium Plated Chain",
      "link": "https://www.amazon.com/SWAROVSKI-Angelic-Bracelet-Crystals-Adjustable/dp/B08834QLPC",
      "rating": 4.7,
      "ratings_total": 338,
      "price": {
        "symbol": "$",
        "value": 79,
        "currency": "USD",
        "raw": "$79"
      }
    },
    {
      "asin": "B0814Y452T",
      "title": "SWAROVSKI Women's Angelic Square Crystal Jewelry Collection, Pink Crystals, Blue Crystals (Amazon Exclusive)",
      "link": "https://www.amazon.com/SWAROVSKI-Womens-Angelic-Necklace-Rhodium/dp/B0814Y452T",
      "rating": 4.7,
      "ratings_total": 1150,
      "price": {
        "symbol": "$",
        "value": 99,
        "currency": "USD",
        "raw": "$99"
      }
    },
    {
      "asin": "B0814YF8H6",
      "title": "SWAROVSKI Women's Angelic Square Crystal Jewelry Collection, Pink Crystals, Blue Crystals (Amazon Exclusive)",
      "link": "https://www.amazon.com/SWAROVSKI-Womens-Angelic-Necklace-Rhodium/dp/B0814YF8H6",
      "rating": 4.7,
      "ratings_total": 1150,
      "price": {
        "symbol": "$",
        "value": 99,
        "currency": "USD",
        "raw": "$99"
      }
    },
    {
      "asin": "B0814YG11S",
      "title": "SWAROVSKI Women's Angelic Square Crystal Jewelry Collection, Pink Crystals, Blue Crystals (Amazon Exclusive)",
      "link": "https://www.amazon.com/SWAROVSKI-Angelic-Pierced-Earrings-Rhodium/dp/B0814YG11S",
      "rating": 4.7,
      "ratings_total": 1150,
      "price": {
        "symbol": "$",
        "value": 59,
        "currency": "USD",
        "raw": "$59"
      }
    },
    {
      "asin": "B0814YP5SX",
      "title": "SWAROVSKI Women's Angelic Square Crystal Jewelry Collection, Pink Crystals, Blue Crystals (Amazon Exclusive)",
      "link": "https://www.amazon.com/SWAROVSKI-Angelic-Pierced-Earrings-Rhodium/dp/B0814YP5SX",
      "rating": 4.7,
      "ratings_total": 1150,
      "price": {
        "symbol": "$",
        "value": 59,
        "currency": "USD",
        "raw": "$59"
      }
    },
    {
      "asin": "B0814YNWFH",
      "title": "Swarovski Women's Crystal Jewelry Sets, Necklace and Earring Collection",
      "link": "https://www.amazon.com/SWAROVSKI-Womens-Angelic-Square-Rhodium/dp/B0814YNWFH",
      "rating": 4.6,
      "ratings_total": 603,
      "price": {
        "symbol": "$",
        "value": 129,
        "currency": "USD",
        "raw": "$129"
      }
    },
    {
      "asin": "B0814YQG5G",
      "title": "SWAROVSKI Women's Angelic Square Crystal Jewelry Collection, Pink Crystals, Blue Crystals (Amazon Exclusive)",
      "link": "https://www.amazon.com/SWAROVSKI-Womens-Angelic-Bracelet-Rhodium/dp/B0814YQG5G",
      "rating": 4.7,
      "ratings_total": 1150,
      "price": {
        "symbol": "$",
        "value": 89,
        "currency": "USD",
        "raw": "$89"
      }
    },
    {
      "asin": "B0814YL6QY",
      "title": "SWAROVSKI Women's Angelic Square Crystal Jewelry Collection, Pink Crystals, Blue Crystals (Amazon Exclusive)",
      "link": "https://www.amazon.com/SWAROVSKI-Womens-Angelic-Bracelet-Rhodium/dp/B0814YL6QY",
      "rating": 4.7,
      "ratings_total": 1150,
      "price": {
        "symbol": "$",
        "value": 89,
        "currency": "USD",
        "raw": "$89"
      }
    },
    {
      "asin": "B08R1X57HL",
      "title": "SWAROVSKI Christmas Ornament Collection, Annual Limited Editions, Collectible, Clear Crystal",
      "link": "https://www.amazon.com/SWAROVSKI-Christmas-Ornament-Limited-Anniversary/dp/B08R1X57HL",
      "rating": 4.8,
      "ratings_total": 23,
      "price": {
        "symbol": "$",
        "value": 89.59,
        "currency": "USD",
        "raw": "$89.59"
      }
    },
    {
      "asin": "B08PV56N1N",
      "title": "SWAROVSKI Christmas Ornament Collection, Annual Limited Editions, Collectible, Clear Crystal",
      "link": "https://www.amazon.com/SWAROVSKI-Christmas-Ornament-Annual-Limited/dp/B08PV56N1N",
      "rating": 4.8,
      "ratings_total": 71,
      "price": {
        "symbol": "$",
        "value": 63.3,
        "currency": "USD",
        "raw": "$63.3"
      }
    }
  ],
  "categories": [
    {
      "name": "Home",
      "link": "https://www.amazon.com/stores/page/E00D877B-C2D4-48E8-90DC-A008CA14C6D1",
      "is_current": false,
      "store_id": "E00D877B-C2D4-48E8-90DC-A008CA14C6D1"
    },
    {
      "name": "SHOP ALL",
      "link": "https://www.amazon.com/stores/page/70F3122D-4966-4242-A8A6-871C8D7E6F8B",
      "is_current": true,
      "store_id": "70F3122D-4966-4242-A8A6-871C8D7E6F8B"
    },
    {
      "name": "Online exclusives",
      "link": "https://www.amazon.com/stores/page/66E3EFB7-F04B-4143-AF48-A3416109A74A",
      "is_current": false,
      "store_id": "66E3EFB7-F04B-4143-AF48-A3416109A74A"
    },
    {
      "name": "Gift ideas",
      "link": "https://www.amazon.com/stores/page/FDF073F3-9AD0-4B4A-8B14-FEC90D3B7EB8",
      "is_current": false,
      "store_id": "FDF073F3-9AD0-4B4A-8B14-FEC90D3B7EB8"
    },
    {
      "name": "New in",
      "link": "https://www.amazon.com/stores/page/A23EDF24-435F-4854-BF22-58113F572D7D",
      "is_current": false,
      "store_id": "A23EDF24-435F-4854-BF22-58113F572D7D"
    },
    {
      "name": "JEWELRY",
      "link": "https://www.amazon.com/stores/page/4F607D84-0EF9-4D0F-855B-82EBA676801E",
      "is_current": false,
      "store_id": "4F607D84-0EF9-4D0F-855B-82EBA676801E"
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 16
  }
}

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