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

Query parameters

Parameter	Description	Default Value
source	Data source. More info.	amazon_pricing
domain	Domain localization for Amazon. The full list of available domains can be found here.	com
query	10-symbol ASIN code	-
start_page	Starting page number	1
pages	Number of pages to retrieve	1
geo_location	The Deliver to location. See our guide to using this parameter here.	-
user_agent_type	Device type and browser. The full list can be found here.	desktop
render	Enables JavaScript rendering. More info.
callback_url	URL to your callback endpoint. More info.	-
parse	true will return structured data.	-

- required parameter

Code examples

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

JSON

{
    "source": "amazon_pricing", 
    "domain": "nl", 
    "query": "B087TXHLVQ",
    "parse": true
}

cURL

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

Python

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=('user', 'pass1'),
    json=payload,
)

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

PHP

<?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, "user" . ":" . "pass1");


$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);

C#

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 = "YOUR_USERNAME";
            const string Password = "YOUR_PASSWORD";

            var parameters = new Dictionary<string, string>()
            {
                { "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);
        }
    }
}

Golang

package main

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

func main() {
	const Username = "YOUR_USERNAME"
	const Password = "YOUR_PASSWORD"

	payload := map[string]string{
		"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))
}

Java

package org.example;

import okhttp3.*;
import org.json.JSONObject;

public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Authorization";
    public static final String USERNAME = "YOUR_USERNAME";
    public static final String PASSWORD = "YOUR_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)
                .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()) {
            assert response.body() != null;
            System.out.println(response.body().string());
        } catch (Exception exception) {
            System.out.println("Error: " + exception.getMessage());
        }

        System.exit(0);
    }

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

Node.js

import fetch from 'node-fetch';

const username = 'YOUR_USERNAME';
const password = 'YOUR_PASSWORD';
const body = {
  'source': 'amazon_pricing',
  'domain': 'nl',
  'query': 'B087TXHLVQ',
  'parse': true
};
const response = await fetch('https://realtime.oxylabs.io/v1/queries', {
  method: 'post',
  body: JSON.stringify(body),
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Basic ' + Buffer.from(`${username}:${password}`).toString('base64'),
  }
});

console.log(await response.json());

HTTP

https://realtime.oxylabs.io/v1/queries?source=amazon_pricing&domain=nl&query=B087TXHLVQ&parse=true&access_token=12345abcde

The example above uses the Realtime integration method. If you would like to use some other integration method in your query (e.g. Push-Pull or Proxy Endpoint), refer to the integration methods section.

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

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