Pricing

The amazon_pricing data source is designed to retrieve Amazon product offer listings. To see what the parsed output looks like, download this JSON file.

Explore output data dictionary for Amazon Pricing, offering a brief description, screenshot, parsed JSON code snippet, and a table defining each parsed field. Navigate through the details using the right-side navigation or scrolling down the page.

Request samples

In the code examples below, we make a request to retrieve product offer listing page for ASIN B087TXHLVQ on amazon.nl marketplace.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "amazon_pricing",
        "domain": "nl",
        "query": "B087TXHLVQ",
        "parse": true
    }'

We use synchronous Realtime integration method in our examples. If you would like to use Proxy Endpoint or asynchronous Push-Pull integration, refer to the integration methods section.

Request parameter values

Generic

Basic setup and customization options for scraping Amazon product offer listings.

ParameterDescriptionDefault Value

source

Sets the scraper.

amazon_pricing

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.

Pagination

Controls for managing the pagination and retrieval of search results.

ParameterDescriptionDefault Value

start_page

Starting page number.

1

pages

Number of pages to retrieve.

1

Structured data

amazon_pricing structured output
{
    "results": [
        {
            "content": {
                "url": "https://www.amazon.com/gp/aod/ajax/ref=dp_aod_unknown_mbc?asin=B07VGRJDFY&pageno=1",
                "asin": "B07VGRJDFY",
                "page": 1,
                "title": "Nintendo Switch with Neon Blue and Neon Red Joy‑Con - HAC-001(-01)",
                "pricing": [
                    {
                        "price": 237.99,
                        "seller": "Gamer Girlz Online",
                        "currency": "USD",
                        "delivery": "Ships from Gamer Girlz Online",
                        "condition": "Used - Acceptable",
                        "seller_id": "A151FB8X73UXPJ",
                        "seller_link": "/gp/aag/main?ie=UTF8&seller=A151FB8X73UXPJ&isAmazonFulfilled=0&asin=B07VGRJDFY&ref_=olp_merch_name_1",
                        "rating_count": 7857,
                        "price_shipping": 3.98,
                        "delivery_options": []
                    },
                    {
                        "price": 242,
                        "seller": "PROSALE (SN Recorded)",
                        "currency": "USD",
                        "delivery": "Ships from PROSALE (SN Recorded)",
                        "condition": "Used - Good",
                        "seller_id": "AWVDPEZSR45X1",
                        "seller_link": "/gp/aag/main?ie=UTF8&seller=AWVDPEZSR45X1&isAmazonFulfilled=0&asin=B07VGRJDFY&ref_=olp_merch_name_2",
                        "rating_count": 7202,
                        "price_shipping": 0,
                        "delivery_options": []
                    },
                    {
                        "price": 242,
                        "seller": "CellularStream",
                        "currency": "USD",
                        "delivery": "Ships from CellularStream",
                        "condition": "Used - Good",
                        "seller_id": "A3GMNP3CXMIPDP",
                        "seller_link": "/gp/aag/main?ie=UTF8&seller=A3GMNP3CXMIPDP&isAmazonFulfilled=0&asin=B07VGRJDFY&ref_=olp_merch_name_3",
                        "rating_count": 7256,
                        "price_shipping": 0,
                        "delivery_options": []
                    },
                    {
                        "price": 244.95,
                        "seller": "Re-Com",
                        "currency": "USD",
                        "delivery": "Ships from Re-Com",
                        "condition": "Used - Good",
                        "seller_id": "A37FI61TFZMV1Y",
                        "seller_link": "/gp/aag/main?ie=UTF8&seller=A37FI61TFZMV1Y&isAmazonFulfilled=0&asin=B07VGRJDFY&ref_=olp_merch_name_4",
                        "rating_count": 16179,
                        "price_shipping": 0,
                        "delivery_options": []
                    },
                    {
                        "price": 242,
                        "seller": "CirQle",
                        "currency": "USD",
                        "delivery": "Ships from CirQle",
                        "condition": "Used - Good",
                        "seller_id": "A3KFAI0ZG0Y40N",
                        "seller_link": "/gp/aag/main?ie=UTF8&seller=A3KFAI0ZG0Y40N&isAmazonFulfilled=0&asin=B07VGRJDFY&ref_=olp_merch_name_5",
                        "rating_count": 43,
                        "price_shipping": 3.99,
                        "delivery_options": []
                    },
                    {
                        "price": 251.99,
                        "seller": "Goldstar Tech",
                        "currency": "USD",
                        "delivery": "Ships from Goldstar Tech",
                        "condition": "Used - Good",
                        "seller_id": "ARJ9CR5IBXBH3",
                        "seller_link": "/gp/aag/main?ie=UTF8&seller=ARJ9CR5IBXBH3&isAmazonFulfilled=0&asin=B07VGRJDFY&ref_=olp_merch_name_6",
                        "rating_count": 56984,
                        "price_shipping": 0,
                        "delivery_options": []
                    },
                    {
                        "price": 254.9,
                        "seller": "VG1shop (Serial # Recorded)",
                        "currency": "USD",
                        "delivery": "Ships from VG1shop (Serial # Recorded)",
                        "condition": "Used - Good",
                        "seller_id": "AZZMAGMBAQU46",
                        "seller_link": "/gp/aag/main?ie=UTF8&seller=AZZMAGMBAQU46&isAmazonFulfilled=0&asin=B07VGRJDFY&ref_=olp_merch_name_7",
                        "rating_count": 147,
                        "price_shipping": 3.99,
                        "delivery_options": []
                    },
                    {
                        "price": 259.59,
                        "seller": "Amazon Warehouse",
                        "currency": "USD",
                        "delivery": "Ships from Amazon.com",
                        "condition": "Used - Good",
                        "seller_id": "",
                        "seller_link": "",
                        "rating_count": 0,
                        "price_shipping": 0,
                        "delivery_options": []
                    },
                    {
                        "price": 259.98,
                        "seller": "JMS Holdings",
                        "currency": "USD",
                        "delivery": "Ships from JMS Holdings",
                        "condition": "Used - Very Good",
                        "seller_id": "A23KD5S5NPGJB5",
                        "seller_link": "/gp/aag/main?ie=UTF8&seller=A23KD5S5NPGJB5&isAmazonFulfilled=0&asin=B07VGRJDFY&ref_=olp_merch_name_9",
                        "rating_count": 3877,
                        "price_shipping": 0,
                        "delivery_options": []
                    },
                    {
                        "price": 259.99,
                        "seller": "SKYTAC",
                        "currency": "USD",
                        "delivery": "Ships from SKYTAC",
                        "condition": "Used - Good",
                        "seller_id": "A2OPXXBQO51PIH",
                        "seller_link": "/gp/aag/main?ie=UTF8&seller=A2OPXXBQO51PIH&isAmazonFulfilled=0&asin=B07VGRJDFY&ref_=olp_merch_name_10",
                        "rating_count": 3,
                        "price_shipping": 3.99,
                        "delivery_options": []
                    }
                ],
                "_warnings": [
                    "Could not parse pricing seller link.",
                    "Could not parse pricing seller link.",
                    "Could not parse rating count."
                ],
                "asin_in_url": "B07VGRJDFY",
                "review_count": 111672,
                "parse_status_code": 12000
            },
            "created_at": "2022-05-09 06:55:44",
            "updated_at": "2022-05-09 06:55:48",
            "page": 1,
            "url": "https://www.amazon.com/gp/aod/ajax/ref=dp_aod_unknown_mbc?asin=B07VGRJDFY&pageno=1",
            "job_id": "6929323004996355073",
            "status_code": 200,
            "parser_type": ""
        }
    ]
}

Output data dictionary

HTML example

The amazon_pricing provides structured representation of pricing information for a specific product available on Amazon. The table below presents a detailed list of each field we parse, along with its description and data type. The table also includes some metadata.

JSON structure

KeyDescriptionType

url

The URL of the Amazon product page.

string

asin

Amazon Standard Identification Number.

string

page

The current page number.

integer

title

The title of the product.

string

pricing

A list of pricing details.

array

asin_in_url

Amazon Standard Identification Number retrieved from the URL.

string

review_count

The total number of reviews.

integer

parse_status_code

The status code of the parsing job. You can see the parser status codes described here.

integer

created_at

The timestamp when the scraping job was created.

timestamp

update_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

parser_type

The type of parser used for parsing the data.

string

In the following sections, parsed JSON code snippets are shortened where more than one item for the result type is available.

Pricing

pricing includes details such as the price, seller, currency, delivery options, condition of the product, seller ID, and links to the seller's page. Additionally, the number of ratings received by the seller may be provided for further context.

...
"pricing": [
    {
        "price": 24,
        "seller": "Amazon.com",
        "currency": "USD",
        "delivery": "Ships from Amazon.com",
        "condition": "New",
        "seller_id": "A2NDNAPHQ3UDKH",
        "seller_link": "/gp/aag/main?ie=UTF8&seller=A2NDNAPHQ3UDKH&isAmazonFulfilled=0&asin=B07H9DVLBB&ref_=olp_merch_name_0",
        "rating_count": 41715,
        "price_shipping": 0,
        "delivery_options": []
    },
...
Key (pricing)DescriptionType

price

The price of the product.

integer

seller

The seller of the product.

string

currency

The currency in which the price is denominated.

string

delivery

The shipping location of the product.

string

condition

The condition of the product.

string

seller_id

The identification of the Amazon seller.

string

seller_link

The URL to the Amazon Seller’s page.

string

rating_count

The total number of ratings submitted for the Amazon product.

integer

price_shipping

The shipping price.

float

delivery_options

Identifies the delivery options available.

array

Last updated