Core APIs
...
Amazon
Core Requests

Search

3min

Amazon Search Results

DESKTOP TABLET MOBILE

SerpWow parses Amazon search results when the engine=amazon request parameter is set.

Amazon Search Results
Amazon Search Results


Below is an example of how Amazon search results are represented in the SerpWow result JSON:

JSON



SerpWow returns the following properties for engine=amazon requests:

Property

Type

Description

amazon_results

array

An array of Search Result objects, containing each of the product results shown on the Search Results page. The Search Result object has the following properties:

  • position
  • number
  • The position of the result on the search results page.



  • title
  • string
  • The product name.



  • brand
  • string
  • The product brand (where shown, note that not all search results page layouts break out the brand separately to the title).



  • asin
  • string
  • The Amazon product ID (ASIN) for the product.



  • link
  • string
  • The product page link.



  • is_prime
  • boolean
  • Determines whether the product is Prime-eligible or not.
    • 

      Document image
      



  • is_amazon_fresh
  • boolean
  • Determines whether the product is an Amazon Fresh product, or not.
    • 

      Document image
      



  • is_whole_foods_market
  • boolean
  • Determines whether the product is a Whole Foods Market product, or not.
    • 

      Document image
      



  • coupon
  • object
  • Coupon Object Present when the "Coupon" badge is shown next to the search result. Contains the following properties:
    • 

      Document image
      
    • 
      1. badge_text
      2. string
      3. The text shown inside the coupon badge (i.e. "Save 5%").
    • 
      1. text
      2. string
      3. The text shown next to the coupon badge (i.e. "with coupon").



  • deal
  • object
  • Deal Object Present when the "Deal" badge is shown next to the search result. Contains the following properties:
    • 

      Document image
      
    • 
      1. link
      2. string
      3. A link to the deal landing page.
    • 
      1. text
      2. string
      3. The text shown next to the deal badge (i.e. "Limited time deal").
    • 
      1. badge_text
      2. string
      3. The text shown inside the deal badge (i.e. "16% off").



  • gift_guide
  • object
  • Gift Guide Object Present when the "Gift Guide" badge is shown next to the search result. Contains the following properties:
    • 

      Document image
      
    • 
      1. link
      2. string
      3. A link to the deal landing page.
    • 
      1. badge_text
      2. string
      3. The text shown inside the gift guide badge (i.e. "Holiday gift guide"). Can be useful in determining the "type" of gift guide the search result appears in.



  • amazons_choice
  • object
  • Amazons Choice Object Present when the "Amazon's Choice" badge is shown next to the search result. Contains the following properties:
    • 

      Document image
      
    • 
      1. link
      2. string
      3. A link to the product.
    • 
      1. keywords
      2. string
      3. The keywords for which this search result is "Amazon's Choice".



  • bestseller
  • object
  • BestSeller Object Present when the "BestSeller" badge is shown next to the search result. More detailed bestseller information can be retrieved from the product page by making a type=product request specifying this search results ASIN. Contains the following properties:
    • 

      Document image
      
    • 
      1. link
      2. string
      3. A link to the Bestsellers page to which this bestseller badge relates.
    • 
      1. category
      2. string
      3. The category name for which this product is a best seller, i.e. "USB Cables".



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



  • sponsored
  • boolean
  • Set to true or false depending on whether the search result is a sponsored listing, or not.



  • authors
  • array
  • Authors Array The authors property contains the authors or artists of the product. Mainly applies to books, music and video products. The author object has the following properties:
    • 
      1. name
      2. string
      3. The name of the author or artist.
    • 
      1. link
      2. string
      3. The link to the author or artist on the Amazon domain, if present.



  • add_on_item
  • object
  • Add-On Item Object The add-on item object is present when the item is part of the Amazon 'add-on item' program. The property will be omitted if the product is not an add-on item.
    • 
      1. is_add_on_item
      2. boolean
      3. True/false indicating whether the product is an add-on item.



  • availability
  • object
  • Availability Object The Availability object is present when Amazon show availability (i.e. stock level) data next to the search reult. The availability property will be omitted if availability information is not shown alongside the search result. The availability object contains the following properties:
    • 
      1. raw
      2. string
      3. The raw availability as shown next to the search result, for example "Only 1 left in stock - order soon".



  • categories
  • array
  • Categories Array An array containing details of the categories shown with this product as displayed next to the search bar at the top of the page. Each object in the array contains the following properties:
    • 
      1. name
      2. string
      3. The name of the category (i.e. "Toys & Games").



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



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



  • delivery
  • object
  • Delivery Object The Delivery object is present when Amazon show delivery information neat to the search result. The delivery object contains the following properties:
    • 
      1. tagline
      2. string
      3. A string containing the tagline associated with the delivery option, for example "Get it as soon as Sat, Oct 3".
    • 
      1. price
      2. object
      3. A price object representing the price and currency of the delivery option. The delivery price object has the same properties as the price objects in the prices array



  • is_carousel
  • boolean
  • Set to true when this search result is part of a carousel. It is not present if the search result is not part of a carousel. If is_carousel=true then the carousel property describes the properties of the carousel this search result if part of.



  • carousel
  • object
  • Carousel Object When a search result is part of a "carousel" (a horizontally scrolling row of search results nested within the main search results) then the carousel object is present. The carousel object contains details of the carousel that this search result is part of. Examples of carousels could be "Highly Rated" or "Today's Deals". The carousel object contains the following properties:
    • 

      Document image
      
    • 
      1. title
      2. string
      3. The title of the carousel that this search result is part of, for example "Highly Rated".
    • 
      1. sub_title
      2. string
      3. The subtitle of the carousel that this search result is part of, for example "Based on star rating and number of customer ratings".
    • 
      1. sponsored
      2. boolean
      3. Set to true when the carousel itself (as-shown in the carousel header section) indicates that the contents of the carousel are all sponsored results.
    • 
      1. id
      2. boolean
      3. The ID of the carousel that this search result is part of.
    • 
      1. total_items
      2. boolean
      3. The total number of items in the carousel that this search result is part of.



  • prices
  • array
  • Prices Array The prices array contains details about the products pricing, as shown underneath the product title. It is an array of price objects, the properties of which are described below:
    • 
      1. symbol
      2. string
      3. The currency symbol, i.e. $ for USD.
    • 
      1. value
      2. number
      3. The price of the Offer.
    • 
      1. currency
      2. string
      3. The currency of the Offer as a ISO 4217 currency code.
    • 
      1. raw
      2. string
      3. The raw price as displayed on the Offer listing.
    • 
      1. name
      2. string
      3. The name of the price if applicable, for example "Kindle", "Hardcover".



  • price
  • object
  • A price object representing the first item in the prices array. This is normally the "main" price for the product and is included as a convienience to make extracting the main price easier.



  • information
  • string
  • The information text, typically shown in bold below the product title and showing the pack quantity. For example 25.4 Fl Oz (Pack of 2) .



  • unit_price
  • string
  • The product unit price, where shown. For example $0.57/Fl Oz .

pagination

object

An object containing details of the pagination section of the page.

  • current
  • number
  • The current page number, if shown.



  • total
  • number
  • The total number of pages available, if shown.


Next Steps      Amazon Search Parameters

Updated 15 Aug 2024
Did this page help you?