Product
The amazon_product data source is designed to retrieve Amazon product pages. To see the response example with retrieved data, download this sample output file in JSON format.
Query parameters
| Parameter | Description | Default Value |
|---|---|---|
source | Data source. More info. |
|
| Domain localization for Amazon. The full list of available domains can be found here. |
|
query | 10-symbol ASIN code | - |
| The Deliver to location. See our guide to using this parameter here. | - |
| Device type and browser. The full list can be found here. |
|
| Enables JavaScript rendering. More info. | |
| URL to your callback endpoint. More info. | - |
|
| - |
| To get accurate pricing/buybox data, set this parameter to |
|
- required parameter
Code examples
In the code example 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.
{
"source": "amazon_product",
"domain": "nl",
"query": "B08Y72CH1F",
"parse": true,
"context": [
{
"key": "autoselect_variant",
"value": true
}]
}curl --user "user:pass1" 'https://realtime.oxylabs.io/v1/queries' -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=('user', 'pass1'),
json=payload,
)
# Print prettified response to stdout.
pprint(response.json())<?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, "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);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 {
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 main
import (
"bytes"
"encoding/json"
"fmt"
"io/ioutil"
"net/http"
)
func main() {
const Username = "YOUR_USERNAME"
const Password = "YOUR_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))
}
import fetch from 'node-fetch';
const username = 'YOUR_USERNAME';
const password = 'YOUR_PASSWORD';
const body = {
'source': 'amazon_product',
'domain': 'nl',
'query': 'B08Y72CH1F',
'parse': true,
'context': [
{'key': 'autoselect_variant', 'value': 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());https://realtime.oxylabs.io/v1/queries?source=amazon_product&domain=nl&query=B08Y72CH1F&parse=true&access_token=12345abcdeThe 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_product structured output
{
"results": [
{
"content": {
"ads": [
{
"pos": 1,
"asin": "B0849GZMZH",
"type": "sponsored_products_bottom",
"price": 129.99,
"title": "LEGO Star Wars: The Mandalorian The Razor Crest 75292 Exclusive Building Kit, New 2020 (1,023 Pieces)",
"images": [
"https://m.media-amazon.com/images/I/51-e5UA3mEL._AC_SR160,160_.jpg"
],
"rating": 5,
"location": "carousel",
"price_upper": 129.99,
"reviews_count": 17530,
"is_prime_eligible": true
},
{
"pos": 2,
"asin": "B01MTGKZ1L",
"type": "sponsored_products_bottom",
"price": 41.98,
"title": "BEST LEARNING Connectrix Junior - Memory Matching Game for Kids - Original Interactive Educational Match Cards Toddler Games for 3-8 Year Olds - Classic 2-Player Concentration Card Toys for Toddlers",
"images": [
"https://m.media-amazon.com/images/I/61hTV7SU27L._AC_SR160,160_.jpg"
],
"rating": 4.5,
"location": "carousel",
"price_upper": 41.98,
"reviews_count": 1033,
"is_prime_eligible": true
},
{
"pos": 3,
"asin": "B07Y29PQ45",
"type": "sponsored_products_bottom",
"price": 53.99,
"title": "Giant Tumbling Timber Toy - Jumbo JR. Wooden Blocks Floor Game for Kids and Adults, 56 Pieces, Premium Pine Wood, Carry Bag - Grows from 2-feet to Over 4-feet While Playing, Life Size Yard Tower Game",
"images": [
"https://m.media-amazon.com/images/I/51fqLxoew5S._AC_SR160,160_.jpg"
],
"rating": 4.5,
"location": "carousel",
"price_upper": 53.99,
"reviews_count": 8859,
"is_prime_eligible": true
},
{
"pos": 4,
"asin": "B00PG9590G",
"type": "sponsored_products_bottom",
"price": 24.95,
"title": "Math for Love Prime Climb",
"images": [
"https://m.media-amazon.com/images/I/51sYfbKBxYL._AC_SR160,160_.jpg"
],
"rating": 4.5,
"location": "carousel",
"price_upper": 24.95,
"reviews_count": 1673,
"is_prime_eligible": true
},
{
"pos": 5,
"asin": "B071ZFX9CG",
"type": "sponsored_products_bottom",
"price": 26.99,
"title": "Kids Sunglasses With UV Protection - 24 Pack - Party Favors - Bulk Pool Party Favors, Goody Bag Fillers, Beach Party Favors, Bulk Party Pack of 2 Dozen in 4 Neon Colors",
"images": [
"https://m.media-amazon.com/images/I/51dv1TonqpL._AC_SR160,160_.jpg"
],
"rating": 4.5,
"location": "carousel",
"price_upper": 26.99,
"reviews_count": 2915,
"is_prime_eligible": true
},
{
"pos": 6,
"asin": "B08NFBCBLY",
"type": "sponsored_products_bottom",
"price": 28.95,
"title": "LEGO Minecraft The Warped Forest 21168 Hands-on Minecraft Nether Creative Playset; Fun Warped Forest Building Toy Featuring Huntress, Piglin and Hoglin, New 2021 (287 Pieces)",
"images": [
"https://m.media-amazon.com/images/I/51C5OW2ZjBL._AC_SR160,160_.jpg"
],
"rating": 5,
"location": "carousel",
"price_upper": 28.95,
"reviews_count": 2051,
"is_prime_eligible": true
},
{
"pos": 7,
"asin": "B07FNWZ57P",
"type": "sponsored_products_bottom",
"price": 12.59,
"title": "FlowFly Kids Lunch box Insulated Soft Bag Mini Cooler Back to School Thermal Meal Tote Kit for Girls, Boys,Blue Camo",
"images": [
"https://m.media-amazon.com/images/I/51M+IdzrPoL._AC_SR160,160_.jpg"
],
"rating": 4.5,
"location": "carousel",
"price_upper": 12.59,
"reviews_count": 3611,
"is_prime_eligible": true
},
{
"pos": 8,
"asin": "B08NFF66Q2",
"type": "sponsored_products_bottom",
"price": 19.99,
"title": "LEGO Star Wars Resistance X-Wing 75297 Building Kit; Awesome Starfighter Building Toy for Kids Aged 4 and Up, Featuring Poe Dameron and BB-8; New 2021 (60 Pieces)",
"images": [
"https://m.media-amazon.com/images/I/516uIct3MrL._AC_SR160,160_.jpg"
],
"rating": 5,
"location": "carousel",
"price_upper": 19.99,
"reviews_count": 1914,
"is_prime_eligible": true
},
{
"pos": 9,
"asin": "B078P5Y56J",
"type": "sponsored_products_bottom",
"price": 29.99,
"title": "Freedom of Speech - Funny Board Games for Adults & Teens - Perfect for a Party or Group Game Night",
"images": [
"https://m.media-amazon.com/images/I/51aHtSK7MtL._AC_SR160,160_.jpg"
],
"rating": 4.5,
"location": "carousel",
"price_upper": 29.99,
"reviews_count": 3482,
"is_prime_eligible": true
},
{
"pos": 10,
"asin": "B083JX5M79",
"type": "sponsored_products_bottom",
"price": 51.99,
"title": "LEGO Star Wars Boba Fett Helmet 75277 Building Kit, Cool, Collectible Star Wars Character Building Set (625 Pieces), Multicolor",
"images": [
"https://m.media-amazon.com/images/I/41f5N3+LFSL._AC_SR160,160_.jpg"
],
"rating": 5,
"location": "carousel",
"price_upper": 51.99,
"reviews_count": 9418,
"is_prime_eligible": true
}
],
"url": "https://www.amazon.com/dp/B07VGRJDFY",
"asin": "B07VGRJDFY",
"page": 1,
"price": 237.99,
"stock": "In Stock.",
"title": "Nintendo Switch with Neon Blue and Neon Red Joy‑Con - HAC-001(-01)",
"coupon": "",
"images": [
"https://m.media-amazon.com/images/I/61-PblYntsL._AC_SL1500_.jpg",
"https://m.media-amazon.com/images/I/41PSrh5lpdL._AC_.jpg",
"https://m.media-amazon.com/images/I/71lfEWM9AYL._AC_SL1500_.jpg",
"https://m.media-amazon.com/images/I/71ILSOE6ovL._AC_SL1500_.jpg",
"https://m.media-amazon.com/images/I/71Qk2M1CIgL._AC_SL1500_.jpg",
"https://m.media-amazon.com/images/I/71CZEg9K3AL._AC_SL1500_.jpg",
"https://m.media-amazon.com/images/I/81LV3J0EA9L._AC_SL1500_.jpg"
],
"rating": 4.8,
"category": [
{
"ladder": [
{
"url": "/computer-video-games-hardware-accessories/b/ref=dp_bc_aui_C_1/134-4248086-1889347?ie=UTF8&node=468642",
"name": "Video Games"
},
{
"url": "/Nintendo-Switch/b/ref=dp_bc_aui_C_2/134-4248086-1889347?ie=UTF8&node=16227128011",
"name": "Nintendo Switch"
},
{
"url": "/b/ref=dp_bc_aui_C_3/134-4248086-1889347?ie=UTF8&node=16227130011",
"name": "Consoles"
}
]
}
],
"currency": "USD",
"delivery": [
{
"date": {
"by": "Sunday, May 15",
"from": null
},
"type": "FREE delivery"
},
{
"date": {
"by": "Tuesday, May 10",
"from": null
},
"type": "Or fastest delivery"
}
],
"_warnings": [
"Could not parse lightning deal."
],
"deal_type": "",
"page_type": "Product",
"price_sns": 0,
"variation": [],
"has_videos": true,
"sales_rank": [
{
"rank": 14,
"ladder": [
{
"url": "/gp/bestsellers/videogames/ref=pd_zg_ts_videogames",
"name": "Video Games "
}
]
},
{
"rank": 1,
"ladder": [
{
"url": "/gp/bestsellers/videogames/16227130011/ref=pd_zg_hrsr_videogames",
"name": "Nintendo Switch Consoles"
}
]
}
],
"top_review": "Mass buying and reselling at high prices should be frowned upon\n\n \nRead more",
"asin_in_url": "B07VGRJDFY",
"description": "Get the gaming system that lets you play the games you want, wherever you are, however you like. Includes the Nintendo Switch console and Nintendo Switch dock in black, with contrasting left and right Joy‑Con controllers-one red, one blue. Also includes all the extras you need to get started. Model number: HAC-001(-01) (product serial number begins with “XKW”) This model includes battery life of approximately 4.5 - 9 hours. The battery life will depend on the games you play. For instance, the battery will last approximately 5.5 hours for The Legend of Zelda: Breath of the Wild (games sold separately). Introducing Nintendo Switch, the new home video game system from Nintendo. In addition to providing single and multiplayer thrills at home, the Nintendo Switch system can be taken on the go so players can enjoy a full home console experience anytime, anywhere. The mobility of a handheld is now added to the power of a home gaming system, with unprecedented new play styles brought to life by the two new Joy-Con controllers. PLAY ANYWHERE Home Gaming System At home the main unit rests in the Nintendo Switch dock, which connects the system to the TV and lets you play with family and friends in the comfort of your living room. On-the-Go Lift Nintendo Switch from the dock and instantly transition to handheld mode for on-the-go gaming. By sharing Joy-Con, players can go head-to-head while away from home. You can also enjoy the same great games in tabletop mode by using the included stand to prop the system up. New Play Styles Remove the detachable Joy-Con from either side of Nintendo Switch for more play styles: One player can use a Joy-Con in each hand Two players can each take one Multiple Joy-Con can be employed by numerous people for a variety of gameplay options (additional Joy-Con sold separately) Slip a set of Joy-Con into a Joy-Con grip accessory, mirroring a more traditional controller. Or, select an optional Nintendo Switch Pro Controller. Bring together up to 8 Nintendo Switch systems for local face-to-face multiplayer. Are Parental Controls available for the Nintendo Switch console? Yes, a robust set of options is included to help both parents and kids have the best possible gaming experience. Parents can set controls on the system, or use the free Nintendo Switch Parental Controls app to set restrictions on games and purchases, monitor gaming time, and more.",
"price_upper": 237.99,
"pricing_str": "New & Used (229) from $237.99",
"pricing_url": "https://www.amazon.com/gp/offer-listing/B07VGRJDFY/ref=dp_olp_ALL_mbc?ie=UTF8&condition=ALL",
"discount_end": "",
"manufacturer": "Nintendo",
"max_quantity": 2,
"price_buybox": -1,
"product_name": "Nintendo Switch with Neon Blue and Neon Red Joy‑Con - HAC-001(-01)",
"bullet_points": "Make sure this fits by entering your model number.\n3 Play Styles: TV Mode, Tabletop Mode, Handheld Mode\n6.2-inch, multi-touch capacitive touch screen\n4.5-9 plus Hours of Battery Life will vary depending on software usage conditions\nConnects over Wi-Fi for multiplayer gaming; Up to 8 consoles can be connected for local wireless multiplayer\nModel number: HAC-001(-01)",
"is_addon_item": false,
"price_initial": 0,
"pricing_count": 229,
"reviews_count": 111672,
"sns_discounts": [],
"developer_info": [],
"lightning_deal": null,
"price_shipping": 0,
"is_prime_pantry": false,
"product_details": {
"asin": "B07VGRJDFY",
"batteries": "3 Lithium ion batteries required. (included)",
"item_weight": "10.2 ounces",
"manufacturer": "Nintendo",
"customer_reviews": "4.8 out of 5 stars 111,672 ratings 4.8 out of 5 stars",
"best_sellers_rank": "#14 in Video Games (See Top 100 in Video Games) #1 in Nintendo Switch Consoles",
"country_of_origin": "China",
"item_model_number": "HADSKABAA",
"product_dimensions": "2 x 2 x 1 inches",
"date_first_available": "August 29, 2019",
"is_discontinued_by_manufacturer": "Yes"
},
"featured_merchant": [],
"is_prime_eligible": false,
"parse_status_code": 12005,
"product_dimensions": "2 x 2 x 1 inches",
"refurbished_product": {
"link": {
"url": "/dp/B081XLG3JJ/ref=dp_cr_wdg_tit_rfb",
"title": "Nintendo Switch V2 Game Console - Black (HAC-001(-01) w/ OEM Blue/Red Joycon (Renewed)"
},
"condition_title": "Buy this product as Renewed and save $20.99 off the current New price."
},
"answered_questions_count": 1000,
"rating_stars_distribution": [
{
"rating": 5,
"percentage": 91
},
{
"rating": 4,
"percentage": 5
},
{
"rating": 3,
"percentage": 1
},
{
"rating": 2,
"percentage": 0
},
{
"rating": 1,
"percentage": 2
}
]
},
"created_at": "2022-05-09 06:56:08",
"updated_at": "2022-05-09 06:56:14",
"page": 1,
"url": "https://www.amazon.com/dp/B07VGRJDFY",
"job_id": "6929323102748806145",
"status_code": 200,
"parser_type": ""
}
]
}Last updated