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
            }
        ]
    }'

import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'amazon_product',
    'domain': 'nl',
    'query': 'B08Y72CH1F',
    'parse': True,
    'context': [
        {'key': 'autoselect_variant', 'value': True}
    ],
}


# Get response.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload,
)

# Print prettified response to stdout.
pprint(response.json())

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "amazon_product",
    domain: "nl",
    query: "B08Y72CH1F",
    parse: true,
    context: [
        { key: "autoselect_variant", value: true },
    ],
};

const options = {
    hostname: "realtime.oxylabs.io",
    path: "/v1/queries",
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        Authorization:
            "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
    },
};

const request = https.request(options, (response) => {
    let data = "";

    response.on("data", (chunk) => {
        data += chunk;
    });

    response.on("end", () => {
        const responseData = JSON.parse(data);
        console.log(JSON.stringify(responseData, null, 2));
    });
});

request.on("error", (error) => {
    console.error("Error:", error);
});

request.write(JSON.stringify(body));
request.end();

https://realtime.oxylabs.io/v1/queries?source=amazon_product&domain=nl&query=B08Y72CH1F&parse=true&context[0][key]=autoselect_variant&context[0][value]=true&access_token=12345abcde

<?php

$params = array(
    'source' => 'amazon_product',
    'domain' => 'nl',
    'query' => 'B08Y72CH1F',
    'parse' => true,
    'context' => [
        ['key' => 'autoselect_variant', 'value' => true]
    ]
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERPWD, "USERNAME" . ":" . "PASSWORD");

$headers = array();
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
echo $result;

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io/ioutil"
	"net/http"
)

func main() {
	const Username = "USERNAME"
	const Password = "PASSWORD"

	payload := map[string]interface{}{
		"source": "amazon_product",
		"domain": "nl",
		"query":  "B08Y72CH1F",
		"parse":  true,
		"context": []map[string]interface{}{
			{"key": "autoselect_variant", "value": true},
		},
	}

	jsonValue, _ := json.Marshal(payload)

	client := &http.Client{}
	request, _ := http.NewRequest("POST",
		"https://realtime.oxylabs.io/v1/queries",
		bytes.NewBuffer(jsonValue),
	)

	request.SetBasicAuth(Username, Password)
	response, _ := client.Do(request)

	responseText, _ := ioutil.ReadAll(response.Body)
	fmt.Println(string(responseText))
}

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Json;
using System.Threading.Tasks;

namespace OxyApi
{
    class Program
    {
        static async Task Main()
        {
            const string Username = "USERNAME";
            const string Password = "PASSWORD";

            var parameters = new {
                source = "amazon_product",
                domain = "nl",
                query = "B08Y72CH1F",
                parse = true,
                context = new dynamic [] {
                    new { key = "autoselect_variant", value = true },
                }
            };

            var client = new HttpClient();

            Uri baseUri = new Uri("https://realtime.oxylabs.io");
            client.BaseAddress = baseUri;

            var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries");
            requestMessage.Content = JsonContent.Create(parameters);

            var authenticationString = $"{Username}:{Password}";
            var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString));
            requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);

            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();

            Console.WriteLine(contents);
        }
    }
}

package org.example;

import okhttp3.*;
import org.json.JSONArray;
import org.json.JSONObject;
import java.util.concurrent.TimeUnit;

public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Authorization";
    public static final String USERNAME = "USERNAME";
    public static final String PASSWORD = "PASSWORD";
    public void run() {
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("source", "amazon_product");
        jsonObject.put("domain", "nl");
        jsonObject.put("query", "B08Y72CH1F");
        jsonObject.put("parse", true);
        jsonObject.put("context", new JSONArray().put(
                new JSONObject()
                        .put("key", "autoselect_variant")
                        .put("value", true)
        ));

        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);

            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };

        var client = new OkHttpClient.Builder()
                .authenticator(authenticator)
                .readTimeout(180, TimeUnit.SECONDS)
                .build();

        var mediaType = MediaType.parse("application/json; charset=utf-8");
        var body = RequestBody.create(jsonObject.toString(), mediaType);
        var request = new Request.Builder()
                .url("https://realtime.oxylabs.io/v1/queries")
                .post(body)
                .build();

        try (var response = client.newCall(request).execute()) {
            if (response.body() != null) {
                try (var responseBody = response.body()) {
                    System.out.println(responseBody.string());
                }
            }
        } catch (Exception exception) {
            System.out.println("Error: " + exception.getMessage());
        }

        System.exit(0);
    }

    public static void main(String[] args) {
        new Thread(new Main()).start();
    }
}

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

Parameter Description Default Value

Parameter	Description	Default 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`

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.

Parameter Description Default Value

Parameter	Description	Default 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.	-

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.

Parameter Description Default Value

Parameter	Description	Default 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`

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&#39;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.

Key Description Type Layout

Key	Description	Type	Layout
`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

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

Key (category)	Description	Type
`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

Key (ads)	Description	Type
`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) Description Type

Key (rating_stars_distribution)	Description	Type
`rating`	Indicates the rating number (scale from 5 to 1).	integer
`percentage`	Indicates the percentage rate for the specific rating.	string

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) Description Type Layout

Key (variations)	Description	Type	Layout
`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

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.

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

Key (warranty_and_support) Description Type

Key (warranty_and_support)	Description	Type
`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

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.

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

Key(featured_merchant) Description Type

Key(featured_merchant)	Description	Type
`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

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.

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

Key(sales_rank) Description Type

Key(sales_rank)	Description	Type
`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

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.

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

Key (delivery)	Description	Type
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

Key (delivery)

Description

Type

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.

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

Key (buybox) Description Type Layout

Key (buybox)	Description	Type	Layout
`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

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.

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

Key(lightning_deal) Description Type

Key(lightning_deal)	Description	Type
`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

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": [
    {
        "title": "Material",
        "description": "Rubber"
    },
    {
        "title": "Vehicle Service Type",
        "description": "Passenger Car"
    },
    {
        "title": "Auto Part Position",
        "description": "Unknown"
    },
    {
        "title": "Fit Type",
        "description": "Universal Fit"
    }
],
...

Key(product_overview) Description Type

Key(product_overview)	Description	Type
`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

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

PreviousAmazon NextSearch

Last updated 4 months ago