Product
The amazon_product
data source is designed to retrieve Amazon product pages.
Request samples
In the samples below, we make a request to retrieve product page for ASIN B08Y72CH1F
on amazon.nl
marketplace. In case the ASIN provided is a parent ASIN, we ask Amazon to return a product page of an automatically-selected variation. API will return parsed results.
We use Realtime integration method in our examples. If you would like to use some other integration method in your request (e.g. Push-Pull or Proxy Endpoint), refer to the integration methods section.
Request parameter values
Generic
Basic setup and customization options for scraping Amazon product pages.
source
Sets the scraper.
amazon_product
query
10-symbol ASIN code.
-
- mandatory parameter
Localization
Adapt results to specific geographical locations, domains, and languages.
IMPORTANT: On most page types, Amazon tailors the returned results based on the delivery location of their customers. Therefore, we advise using the geo_location
parameter to set your preferred delivery location. You can read more about using geo_location
with Amazon here.
Other
Additional advanced settings and controls for specialized requirements.
context
:
autoselect_variant
To get accurate pricing/buybox data, set this parameter to true
(which tells us to append the th=1&psc=1
URL parameters to the end of the product URL). To get an accurate representation of the parent ASIN's product page, omit this parameter or set it to false
.
false
Structured data
E-Commerce Scraper API is capable of extracting either an HTML or JSON object that contains Amazon product results, offering structured data on various elements of the results page.
Output data dictionary
Navigate through the details using the right-side navigation or scrolling down the page.
In the following sections, parsed JSON code snippets are shortened where more than one item for the result type is available.
HTML example
JSON Structure
The table below presents a detailed list of each Amazon product page element we parse, including its description, data type, and whether the element is always present in the layout or optional depending on the product you choose to scrape. The table also includes some metadata.
url
The URL of the Amazon product.
string
page
The current page number.
integer
page_type
Identifies the type of the Amazon page.
string
asin
Amazon Standard Identification Number.
string
asin_in_url
Extracts the Amazon Standard Identification Number from the URL.
string
title
The title of the product.
string
manufacturer
The name of the manufacturer of the product.
string
product_name
The name of the product.
string
description
The description of the product, parsed from the 'Product description' section.
string
bullet_points
The bullet point items parsed from the 'About this product' section.
string
optional
category
A list containing the more details on the category of the Amazon product.
array
optional
variation
A list containing more details on the variations of the Amazon product.
array
optional
rating
The rating of the product.
integer
price
The price of the product.
integer
price_upper
The upper limit of the price.
integer
optional
price_sns
Identifies if product is a part of 'Subscribe & Save' program.
integer
price_initial
The original, non-discounted price of a product.
integer
price_shipping
The price of the shipping.
integer
optional
price_buybox
The price of the product as visible in the buybox.
integer
deal_type
Identifies the category of promotional offer.
string
optional
coupon
Indicates any digital discounts available.
string
optional
is_prime_eligible
Indicates whether the product is eligible for Amazon Prime.
boolean
is_addon_item
Indicates whether a product is available for purchase only when included in orders meeting a minimum value threshold.
boolean
optional
currency
The currency in which the price is denominated.
string
discount_end
Indicates the final date on which a promotional discount for an Amazon product is valid till.
string
optional
stock
Indicates the inventory level of the product.
string
reviews_count
The count of reviews for the product.
integer
top_review
The highest-rated and most helpful customer review for an Amazon product.
string
optional
answered_questions_count
The total number of customer questions about an Amazon product that have been answered.
integer
optional
pricing_count
The count of offers for the product.
integer
optional
pricing_url
The URL to retrieve Amazon product offer listings.
string
optional
pricing_str
A string representation of the pricing details for an Amazon product. This attribute includes information on the current price, any discounts, promotions, and special offers
string
optional
featured_merchant
A list of details on the primary seller or vendor highlighted for an Amazon product.
object
optional
sales_rank
A list of information about the ranking position of an Amazon product within its respective category based on its sales performance.
array
optional
sns_discounts
Indicates any discounts available as part of the 'Subscribe & Save' program.
array
developer_info
Information related to the developer or manufacturer of an Amazon product.
object
optional
images
A list of URLs indicating the product images.
array
product_overview
A list of key attributes and their descriptions for the product, providing essential details about the product's characteristics.
array
optional
has_videos
Indicates if the product has any videos.
boolean
delivery
A list of information on the delivery options.
object
optional
brand
The brand of the product.
string
optional
sales_volume
The quantity of units sold within a specific timeframe.
string
optional
rating_stars_distribution
A list of details on the ratings of the product.
array
optional
buybox
A list of details on the product’s pricing.
array
optional
lightning_deal
Indicates whether there is a time-limited promotional offer available for the product.
object
optional
product_details
A list of information on the details of the product.
object
optional
product_dimensions
The dimensions of the product.
string
optional
max_quantity
The maximum number of units of an Amazon product that a customer is allowed to purchase in a single order.
integer
optional
warranty_and_support
A list of details on the warranty of the product.
object
optional
discount.percentage
The percentage reduction applied to the original price of an Amazon product.
integer
optional
amazon_choice
Indicates if the product has the Amazon's Choice badge.
boolean
optional
coupon_discount_percentage
Indicates the percentage reduction amount applicable with a coupon.
integer
optional
parent_asin
The primary identifier for Amazon product family which a product is attributed to.
string
optional
created_at
The timestamp when the scraping job was created.
timestamp
updated_at
The timestamp when the scraping job was finished.
timestamp
job_id
The ID of the job associated with the scraping job.
string
status_code
The status code of the scraping job. You can see the scraper status codes described here.
integer
parse_status_code
The status code of the parsing job. You can see the parser status codes described here.
integer
Category
This field shows the hierarchical structure of product categories for an Amazon product. Each category in the ladder is an object with a name and URL, representing the path from the broadest category to the most specific subcategory.
ladder
A list containing breadcrumbs of the Amazon product.
array
ladder.name
The name of the breadcrumb/category of the Amazon product.
string
ladder.url
The URL of the breadcrumb/category.
string
Ads
This field contains information about ads displayed on an Amazon product page. Each ad is represented as an object with details such as type, location, title, ASIN, images, position, rating, reviews count, Prime eligibility, and price.
type
The type of the Amazon ad.
string
location
The name of the Amazon ad placement.
string
title
The title of the product.
string
asin
Amazon Standard Identification Number.
string
images
The URL of the product image/images.
string
pos
A unique indicator denoting the position of an ad in regards to all available ads results.
integer
rating
The rating of the product.
integer
reviews_count
The count of reviews for the product.
integer
is_prime_eligible
Indicates whether the product is eligible for Amazon Prime.
boolean
price
The price of the product.
integer
price_upper
The upper limit of the price if applicable.
integer
Rating Stars Distribution
This field contains the distribution of star ratings for a product. Each object represents a star rating and the percentage of total reviews that gave this rating.
rating
Indicates the rating number (scale from 5 to 1).
integer
percentage
Indicates the percentage rate for the specific rating.
string
Variations
This field contains information about different variations of a product, such as color, size, style, etc. Each variation is represented as an object with details including ASIN, selection status, dimensions (attributes like color, size, style), and a tooltip image URL.
asin
The Amazon Standard Identification Number of product variant.
array
selected
Identifies the selected product variant.
boolean
dimensions
The dimensions of the variant product.
object
optional
dimensions.size
The size of the variant product.
string
optional
dimensions.color
The color of the variant product.
string
optional
dimensions.style
The style of the variant product.
string
optional
dimensions.unit count
The standard unit count of the variant product.
string
optional
tooltip_image
The URL of the variant image.
string
optional
Warranty and Support
This field contains information about the warranty and support options for the product. It includes a description of the product warranty and links to obtain warranty information.
description
The description of the warranty available for the product.
string
links
A list containing more information on the warranty of the product.
array
links.title
The title of the warranty.
string
links.url
A URL containing more information on the warranty of the product.
string
Featured Merchant
This field provides information about the featured merchant selling the product. It includes details such as the merchant's name, seller ID, link to the merchant's page, whether the product is Amazon fulfilled, and the shipping origin.
name
The name of the primary seller.
string
seller_id
The ID of the seller.
string
link
The URL of the Amazon seller page.
string
is_amazon_fulfilled
Indicates whether a product is fulfilled by Amazon's own logistics network
boolean
shipped_from
(optional)
Indicates the shipping location.
string
Sales Rank
This field provides information about the sales rank of the product within specific categories on Amazon. Each object represents a sales rank entry, including the rank itself and the category ladder, showing the hierarchy of categories leading to the ranked category.
rank
Indicates the ranking position.
integer
ladder
A list of more detailed information on the category the product has been ranked in.
array
ladder.url
The URL to the relevant Bestsellers category page.
string
ladder.name
Indicates the category which the product has been ranked in.
string
Delivery
This field provides information about delivery options for the product, such as the fastest delivery method and estimated arrival dates.
type
Indicates the type of the delivery.
string
date
A list of information on the delivery date.
object
date.from
The shipping location.
string
date.by
The estimated delivery date.
string
Buy Box
The "buy box" section on an Amazon product page where customers can directly purchase items. This field provides essential information for buyers, including the product price, stock availability, delivery options, and estimated arrival dates.
name
The name of the pricing option.
string
optional
stock
The inventory level of the product.
string
optional
delivery_type
Indicates the type of the delivery.
string
optional
delivery_details
A list of details on the delivery of the product.
array
optional
date
A list of details on the delivery date.
object
optional
delivery_details.by
The estimated delivery date.
string
optional
delivery_details.from
The shipping location of the product.
string
optional
delivery_details.type
The type of the delivery
string
optional
condition
The condition of the product.
string
optional
price
The price of the product.
integer
Lightning Deal
This field provides details about a lightning deal on Amazon, offering a discounted price for a limited time. Lightning deals are time-limited promotions with significant discounts on specific products, available for a few hours in limited quantities. Customers must act quickly as deals expire once the allocated time or inventory runs out. Details include the percentage claimed, discounted price, and time remaining before the deal expires.
percent_claimed
The discounted amount compared to the default price.
string
price_text
The discounted product price.
string
expires
Indicates the ending date of the lightning deal offer.
string
Product Overview
This section provides a structured summary of various key attributes related to a product.
product_overview
A list of key attributes and their descriptions for the product.
Array
title
The title of the product attribute.
string
description
The detailed description of the product attribute.
string
Last updated