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.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "amazon_product",
        "domain": "nl",
        "query": "B08Y72CH1F",
        "parse": true,
        "context": [
            {
                "key": "autoselect_variant",
                "value": true
            }
        ]
    }'

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.

ParameterDescriptionDefault Value

source

Sets the scraper.

amazon_product

query

10-symbol ASIN code.

-

render

Enables JavaScript rendering when set to html. More info.

-

parse

Returns parsed data when set to true. Explore output data dictionary.

false

callback_url

URL to your callback endpoint. More info.

-

user_agent_type

Device type and browser. The full list can be found here.

desktop

- mandatory parameter

Localization

Adapt results to specific geographical locations, domains, and languages.

ParameterDescriptionDefault Value

geo_location

The Deliver to location. See our guide to using this parameter here.

-

domain

Domain localization for Amazon. The full list of available domains can be found here.

com

locale

Accept-Language header value, which sets the interface language of the Amazon page. More info.

-

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.

ParameterDescriptionDefault Value

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.

amazon_product structured output
{
    "url": "https://www.amazon.in/dp/B073GZNWL1",
    "page": 1,
    "page_type": "Product",
    "asin": "B073GZNWL1",
    "asin_in_url": "B073GZNWL1",
    "title": "Pampers Large Size Diapers Pants (128 Count)",
    "manufacturer": "Pampers",
    "product_name": "Pampers Large Size Diapers Pants (128 Count)",
    "description": "Size: Large | Unit Count: 128 New Pampers baby dry pants style diapers have 3 revolutionary extra absorb channels, that help distribute wetness evenly throughout the pants diapers, so wetness doesn’t collect in one place. Their magic gel layer locks wetness inside and offers up to 12 hours of dryness to help your baby sleep soundly all night.",
    "bullet_points": "Revolutionary 3 extra absorb channels that help distribute wetness evenly\nThese diaper pants have magic gel that locks wetness away for up to 12 hours of dryness\nFlexible waist band on these diaper pants adapts to baby's movements for comfortable fit\nBreathable soft belt and leg cuffs to help air circulate and keep your baby's skin fresh\nBaby lotion that moisturizes and nourishes your baby's skin to protect it from diaper rash and irritation",
    "category": [
        {
            "ladder": [
                {
                    "name": "Baby",
                    "url": "/Baby/b/ref=dp_bc_1?ie=UTF8&node=1571274031"
                },
                ...
                {
                    "name": "Diaper Pants",
                    "url": "/Training-Diapers/b/ref=dp_bc_4?ie=UTF8&node=1953352031"
                }
            ]
        }
    ],
    "variation": [
        {
            "asin": "B06XRGX8FC",
            "selected": false,
            "dimensions": {
                "Size": "Large",
                "Unit Count": "68"
            }
        },
        ...
        {
            "asin": "B01CFYRJTI",
            "selected": false,
            "dimensions": {
                "Size": "Small",
                "Unit Count": "42"
            }
        }
    ],
    "rating": 4.3,
    "price": 1299.0,
    "price_upper": 1299.0,
    "price_sns": 1299.6,
    "price_initial": 1999.0,
    "price_shipping": 0.0,
    "price_buybox": 1368.0,
    "deal_type": "Deal Price",
    "coupon": "",
    "is_prime_pantry": false,
    "is_prime_eligible": true,
    "is_addon_item": false,
    "currency": "INR",
    "discount_end": "2017-11-30T16:30:02+00:00",
    "stock": "In stock.",
    "reviews_count": 13270,
    "top_review": "Baby feels comfortable wearing pampers during playtime as well as sleeping time. Induce far lesser rashes than any other brands in this range. Each diaper functions well for minimum 5 HRS depending upon pee frequency. Received original product with latest manufacturing date. I appreciate Amazon for maintaining high quality of product as well as services.Read more",
    "answered_questions_count": 152,
    "pricing_count": 4,
    "pricing_url": "https://www.amazon.in/gp/offer-listing/B073GZNWL1/ref=dp_olp_new?ie=UTF8&condition=new",
    "pricing_str": "4 offers from 1,368.00",
    "featured_merchant": {
        "name": "Cloudtail India",
        "seller_id": "AT95IG9ONZD7S",
        "link": "/gp/help/seller/at-a-glance.html/ref=dp_merchant_link?ie=UTF8&seller=AT95IG9ONZD7S&isAmazonFulfilled=1",
        "is_amazon_fulfilled": true,
        "shipped_from": "Amazon"
    },
    "sales_rank": [
        {
            "rank": 11,
            "ladder": [
                {
                    "url": "https://www.amazon.in/gp/bestsellers/baby/ref=pd_dp_ts_baby_1",
                    "name": "Baby Products"
                }
            ]
        },
        {
            "rank": 10,
            "ladder": [
                {
                    "url": "https://www.amazon.in/gp/bestsellers/baby/ref=pd_zg_hrsr_baby_1_1",
                    "name": "Baby Products"
                },
                ...
                {
                    "url": "https://www.amazon.in/gp/bestsellers/baby/1953352031/ref=pd_zg_hrsr_baby_1_4_last",
                    "name": "Diaper Pants"
                }
            ]
        }
    ],
    "sns_discounts": [],
    "developer_info": {},
    "images": [
        "https://images-na.ssl-images-amazon.com/images/I/81%2B12fymboL._SL1500_.jpg",
        ...
        "https://images-na.ssl-images-amazon.com/images/I/71vYb-QJA8L._SL1500_.jpg"
    ],
    "has_videos": false,
    "delivery": [],
    "parse_status_code": 12000,
    "rating_stars_distribution": [
        {
            "rating": 5,
            "percentage": 69
        },
        ...
    ],
    "lightning_deal": {
        "percent_claimed": "13%",
        "price_text": "1,299.00  (Save 35%)",
        "expires": "Ends in  06h 44m 39s"
    },
    "max_quantity": 2,
    "amazon_choice": true,
    "ads": [
        {
            "type": "sponsored_products",
            "location": "carousel",
            "title": "Johnson's Baby Skincare Wipes, 2*80 cloth wipes (Pack of 2, Rs. 60 off)",
            "asin": "B00EZQ5DD4",
            "images": [
                "https://images-eu.ssl-images-amazon.com/images/I/411DD3w9xLL._AC_SR150,150_.jpg"
            ],
            "pos": 1,
            "rating": 4.5,
            "reviews_count": 1864,
            "is_prime_eligible": true,
            "price": 310.0,
            "price_upper": 310.0
        },
        ...
        {
            "type": "sponsored_products_bottom",
            "location": "carousel",
            "title": "Pampers Extra Small Size Premium New Born Care Diaper Pants (24 Count)",
            "asin": "B01CFX8ELQ",
            "images": [
                "https://images-eu.ssl-images-amazon.com/images/I/51Iz8Ua9s5L._AC_SR150,150_.jpg"
            ],
            "pos": 1,
            "rating": 4.5,
            "reviews_count": 4881,
            "is_prime_eligible": true,
            "price": 221.0,
            "price_upper": 221.0
        },
        ...
        {
            "type": "organic_also_viewed",
            "location": "carousel",
            "title": "Mee Mee Caring Baby Wet Wipes with Aloe Vera (72 pcs) (Pack of 3)",
            "asin": "B00DRE0LQY",
            "images": [
                "https://images-na.ssl-images-amazon.com/images/I/61mtV3nCAjL._AC_UL160_SR120,160_.jpg"
            ],
            "pos": 1,
            "rating": 4.2,
            "reviews_count": 4243,
            "is_prime_eligible": true,
            "price": 275.0,
            "price_upper": 275.0
        },
        ...
        {
            "type": "organic_also_viewed",
            "location": "carousel",
            "title": "Pampers New Baby Diapers (24 Count)",
            "asin": "B00AWMBLZ4",
            "images": [
                "https://images-na.ssl-images-amazon.com/images/I/81dt5zb3ybL._AC_UL160_SR160,160_.jpg"
            ],
            "pos": 12,
            "rating": 4.1,
            "reviews_count": 9176,
            "is_prime_eligible": true,
            "price": 284.0,
            "price_upper": 284.0
        }
    ],
    "parent_asin": "B0752ZNPBR"
}

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.

KeyDescriptionTypeLayout

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.

 "category": [
        {
            "ladder": [
                {
                    "name": "Office Products",
                    "url": "/office-products-supplies-electronics-furniture/b/ref=dp_bc_aui_C_1/133-6156367-1346746?ie=UTF8&node=1064954"
                },
                {
                    "name": "Office & School Supplies",
                    "url": "/Office-Supplies/b/ref=dp_bc_aui_C_2/133-6156367-1346746?ie=UTF8&node=1069242"
                },
                {
                    "name": "Paper",
                    "url": "/b/ref=dp_bc_aui_C_3/133-6156367-1346746?ie=UTF8&node=1069664"
                },
                {
                    "name": "Notebooks & Writing Pads",
                    "url": "/Notebooks-Writing-Pads/b/ref=dp_bc_aui_C_4/133-6156367-1346746?ie=UTF8&node=1069756"
                },
                {
                    "name": "Hardcover Executive Notebooks",
                    "url": "/Hardcover-Executive-Notebooks/b/ref=dp_bc_aui_C_5/133-6156367-1346746?ie=UTF8&node=490755011"
                }
            ]
        }
    ],
Key (category)DescriptionType

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.

...                   
  "ads": [
        {
            "type": "organic_also_viewed",
            "location": "carousel",
            "title": "Camkix Tangentbordsrengöringssats – 1 x miniborste, 1 x rengöringsborste, 1 x tangentbordslockborttagare, 1 x luftfläkt och 1 x rengöringsduk – även för bärbara datorer, kameralinser, glasögon – hem och kontor",
            "asin": "B07SRV9HQ4",
            "images": [
                "https://images-eu.ssl-images-amazon.com/images/I/81t5eLB69SL._AC_UL160_SR160,160_.jpg"
            ],
            "pos": 1,
            "rating": 4.3,
            "reviews_count": 840,
            "is_prime_eligible": false,
            "price": 134.99,
            "price_upper": 134.99
        },
...
]
...
Key (ads)DescriptionType

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_stars_distribution": [
        {
            "rating": 5,
            "percentage": 87
        },
        {
            "rating": 4,
            "percentage": 8
        },
        {
            "rating": 3,
            "percentage": 2
        },
        {
            "rating": 2,
            "percentage": 1
        },
        {
            "rating": 1,
            "percentage": 2
        }
    ],
...
Key (rating_stars_distribution)DescriptionType

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.

 ...
"variation": [
        {
            "asin": "B07RM6QYWC",
            "selected": false,
            "dimensions": {
                "Color": "Ocean Blue",
                "Size": "128GB",
                "Style": "Verizon"
            },
            "tooltip_image": "https://m.media-amazon.com/images/I/41zzpCgao9L._SS36_.jpg"
        },
...
Key (variations)DescriptionTypeLayout

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