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

import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'amazon_pricing',
    'domain': 'nl',
    'query': 'B087TXHLVQ',
    'parse': 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_pricing",
    domain: "nl",
    query: "B087TXHLVQ",
    parse: 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_pricing&domain=nl&query=B087TXHLVQ&parse=true&access_token=12345abcde

<?php

$params = array(
    'source' => 'amazon_pricing',
    'domain' => 'nl',
    'query' => 'B087TXHLVQ',
    'parse' => 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_pricing",
		"domain": "nl",
		"query":  "B087TXHLVQ",
		"parse":  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_pricing",
                domain = "nl",
                query = "B087TXHLVQ",
                parse = 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.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_pricing");
        jsonObject.put("domain", "nl");
        jsonObject.put("query", "B087TXHLVQ");
        jsonObject.put("parse", 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_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.

Parameter

Description

Default Value

source

Sets the scraper.

amazon_pricing

query

10-symbol ASIN code

render

Enables JavaScript rendering when set to html. .

parse

Returns parsed data when set to true. Explore output .

false

callback_url

URL to your callback endpoint. .

user_agent_type

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

desktop

- mandatory parameter

Localization

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

Parameter

Description

Default Value

geo_location

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

domain

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

com

locale

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

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.

Parameter

Description

Default 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

Key

Description

Type

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 .

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.

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)

Description

Type

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

PreviousSearch NextSellers

Last updated 1 month ago