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.

- 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.

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.

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"
                }
            ]
        }
    ],

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
        },
...
]
...

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
        }
    ],
...

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"
        },
...

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.

...
 "warranty_and_support": {
        "description": "Product Warranty: For warranty information about this product, please click here",
        "links": [
            {
                "title": "click here",
                "url": "/gp/feature.html/ref=dp_warranty_request_3P?docId=1002406021"
            }
        ]
    },
...

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.

... 
 "featured_merchant": {
        "name": "LYTEK LLC",
        "seller_id": "A2OL0VKAHK1LYK",
        "link": "/gp/help/seller/at-a-glance.html/ref=dp_merchant_link?ie=UTF8&seller=A2OL0VKAHK1LYK&isAmazonFulfilled=1",
        "is_amazon_fulfilled": true,
        "shipped_from": "Amazon"
    },
...

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.

...
"sales_rank": [
        {
            "rank": 1366,
            "ladder": [
                {
                    "url": "/gp/bestsellers/office-products/ref=pd_zg_ts_office-products",
                    "name": "Office Products "
                }
            ]
        },
        {
            "rank": 18,
            "ladder": [
                {
                    "url": "/gp/bestsellers/office-products/490755011/ref=pd_zg_hrsr_office-products",
                    "name": "Hardcover Executive Notebooks"
                }
            ]
        }
    ],
...

Delivery

This field provides information about delivery options for the product, such as the fastest delivery method and estimated arrival dates.

...
    "delivery": [
        {
            "type": "Fastest delivery",
            "date": {
                "from": null,
                "by": "Thursday, Jan 28"
            }
        }
    ],
...

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.

...
"buybox": [
    {
        "price": 199.99,
        "stock": "Only 1 left in stock - order soon.",
        "delivery_type": "Delivery",
        "delivery_details": [
            {
                "date": {
                    "by": "Thursday, June 6",
                    "from": null
                },
                "type": "FREE delivery"
            },
            {
                "date": {
                    "by": "Tuesday, June 4",
                    "from": null
                },
                "type": "Or fastest delivery"
            }
        ]
    },
...

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.

...
"lightning_deal": {
        "percent_claimed": "0%",
        "price_text": "10,999.00  (Save 52%)",
        "expires": "Ends in  06h 30m 56s"
    },
...

Product Overview

This section provides a structured summary of various key attributes related to a product.

...
"product_overview": [
    {
        "title": "Material",
        "description": "Rubber"
    },
    {
        "title": "Vehicle Service Type",
        "description": "Passenger Car"
    },
    {
        "title": "Auto Part Position",
        "description": "Unknown"
    },
    {
        "title": "Fit Type",
        "description": "Universal Fit"
    }
],
...

Last updated