Search

The amazon_search source is designed to retrieve Amazon search result pages. To see the response example with retrieved data, download this sample output file in HTML format or check structured data output here.

Explore data dictionary for each Amazon Search feature, 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

Parameter	Description	Default Value
source	Data source. More info.	`amazon_search`
`domain`	Domain localization for Amazon. The full list of available domains can be found here.	`com`
query	UTF-encoded keyword	-
`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.	-
`context`: `category_id`	Search for items in a particular browse node (product category).	-
`context`: `merchant_id`	Search for items sold by a particular seller.	-

source

Data source. More info.

amazon_search

domain

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

com

query

UTF-encoded keyword

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.

context: category_id

Search for items in a particular browse node (product category).

context: merchant_id

Search for items sold by a particular seller.

- required parameter

Code examples

In the code examples below, we make a request to retrieve a result from amazon.nl, which includes 2 search results pages, starting from page #2 , for the search term nirvana tshirt. Additionally, the search is be limited to category ID: 16391693031.

{
    "source": "amazon_search", 
    "domain": "nl", 
    "query": "nirvana tshirt", 
    "start_page": 2, 
    "pages": 2,
    "parse": true, 
    "context": [
        {
            "key": "category_id", 
            "value": "16391693031"
        }]
}

curl --user "user:pass1" 'https://realtime.oxylabs.io/v1/queries' -H "Content-Type: application/json"
 -d '{"source": "amazon_search", "domain": "nl", "query": "nirvana tshirt", "start_page": 2, "pages": 2, "parse": true, "context" [{"key": "category_id", "value": "16391843031"}]}'

import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'amazon_search',
    'domain': 'nl',
    'query': 'nirvana tshirt',
    'start_page': 2,
    'pages': 2,
    'parse': True,
    'context': [
        {'key': 'category_id', 'value': 16391693031}
    ],
}


# 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_search',
    'domain' => 'nl',
    'query' => 'nirvana tshirt',
    'start_page' => 2,
    'pages' => 2,
    'parse' => true,
    'context' => [
      [
        'key' => 'category_id', 
        'value' => 16391693031,
      ]
    ],
);

$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_search",
                domain = "nl",
                query = "nirvana tshirt",
                start_page = 2,
                pages = 2,
                parse = true,
                context = new dynamic [] {
                    new { key = "category_id", value = 16391693031 }
                }
            };

            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_search",
		"domain":     "nl",
		"query":      "nirvana tshirt",
		"start_page": 2,
		"pages":      2,
		"parse":      true,
		"context": []map[string]interface{}{
			{"key": "category_id", "value": 16391693031},
		},
	}

	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_search',
  'domain': 'nl',
  'query': 'nirvana tshirt',
  'start_page': 2,
  'pages': 2,
  'parse': true,
  'context': [
        {'key': 'category_id', 'value': 16391693031}
    ],
};
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());

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.

Sample output

amazon_search structured output

{
    "results": [
        {
            "content": {
                "url": "https://www.amazon.com/s?k=nintendo&page=1",
                "page": 1,
                "pages": 1,
                "query": "nintendo",
                "results": {
                    "paid": [
                        {
                            "url": "https://aax-us-iad.amazon.com/x/c/QrZs2avUSMjSeFnSikdVXTcAAAGAp5uVgQEAAAH2AXJovXc/https://www.amazon.com/gp/aw/d/B08ZBB6ZQZ/?_encoding=UTF8&pd_rd_plhdr=t&aaxitk=a319e6e5e902944e8b9ecd7817c42a79&hsa_cr_id=6671739720301&ref_=sbx_be_s_sparkle_lsi4d_asin_0_img&pd_rd_w=cpsRw&pf_rd_p=488a18be-6d86-4de0-8607-bd4ea4b560f3&pd_rd_wg=NzeYP&pf_rd_r=N166FCB5NH3W1RXBZHDD&pd_rd_r=27c1ccda-5e73-4203-8855-62f5a74d9804",
                            "asin": "B08ZBB6ZQZ",
                            "price": 0,
                            "title": "LEGO Star Wars: The Mandalorian Imperial Light Cruiser 75315 Awesome Toy Building Kit for Kids, Featuring 5 Minifigures; New 2021 (1,336 Pieces)",
                            "rating": 4.9,
                            "rel_pos": 1,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/81gfUA+YEKL._AC_SR160,134_QL70_.jpg",
                            "best_seller": false,
                            "price_upper": 0,
                            "is_sponsored": true,
                            "manufacturer": "",
                            "pricing_count": 1,
                            "reviews_count": 1213,
                            "is_amazons_choice": false
                        },
                        {
                            "url": "https://aax-us-iad.amazon.com/x/c/QrZs2avUSMjSeFnSikdVXTcAAAGAp5uVgQEAAAH2AXJovXc/https://www.amazon.com/gp/aw/d/B08HVXPWMP/?_encoding=UTF8&pd_rd_plhdr=t&aaxitk=a319e6e5e902944e8b9ecd7817c42a79&hsa_cr_id=6671739720301&ref_=sbx_be_s_sparkle_lsi4d_asin_1_img&pd_rd_w=cpsRw&pf_rd_p=488a18be-6d86-4de0-8607-bd4ea4b560f3&pd_rd_wg=NzeYP&pf_rd_r=N166FCB5NH3W1RXBZHDD&pd_rd_r=27c1ccda-5e73-4203-8855-62f5a74d9804",
                            "asin": "B08HVXPWMP",
                            "price": 0,
                            "title": "LEGO Star Wars: A New Hope Mos Eisley Cantina 75290 Building Kit; Awesome Construction Model for Display, New 2021 (3,187 Pieces)",
                            "rating": 4.8,
                            "rel_pos": 2,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/81EyuzZROiL._AC_SR160,134_QL70_.jpg",
                            "best_seller": false,
                            "price_upper": 0,
                            "is_sponsored": true,
                            "manufacturer": "",
                            "pricing_count": 1,
                            "reviews_count": 1313,
                            "is_amazons_choice": false
                        },
                        {
                            "url": "https://aax-us-iad.amazon.com/x/c/QrZs2avUSMjSeFnSikdVXTcAAAGAp5uVgQEAAAH2AXJovXc/https://www.amazon.com/gp/aw/d/B0849GZMZH/?_encoding=UTF8&pd_rd_plhdr=t&aaxitk=a319e6e5e902944e8b9ecd7817c42a79&hsa_cr_id=6671739720301&ref_=sbx_be_s_sparkle_lsi4d_asin_2_img&pd_rd_w=cpsRw&pf_rd_p=488a18be-6d86-4de0-8607-bd4ea4b560f3&pd_rd_wg=NzeYP&pf_rd_r=N166FCB5NH3W1RXBZHDD&pd_rd_r=27c1ccda-5e73-4203-8855-62f5a74d9804",
                            "asin": "B0849GZMZH",
                            "price": 0,
                            "title": "LEGO Star Wars: The Mandalorian The Razor Crest 75292 Exclusive Building Kit, New 2020 (1,023 Pieces)",
                            "rating": 4.9,
                            "rel_pos": 3,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/918CAx5r5PL._AC_SR160,134_QL70_.jpg",
                            "best_seller": false,
                            "price_upper": 0,
                            "is_sponsored": true,
                            "manufacturer": "",
                            "pricing_count": 1,
                            "reviews_count": 17530,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 1,
                            "url": "/gp/slredirect/picassoRedirect.html/ref=pa_sp_atf_aps_sr_pg1_1?ie=UTF8&adId=A008843028LW25U0JPXHU&url=/Easy-steps-get-connected-833-951-2799-ebook/dp/B09YY6QQRM/ref=sr_1_1_sspa?keywords=nintendo&qid=1652079433&sr=8-1-spons&psc=1&qualifier=1652079433&id=2653787596297387&widgetName=sp_atf",
                            "asin": "B09YY6QQRM",
                            "price": 0,
                            "title": "Easy steps to get connected : Phone number for amazon 833-951-2799",
                            "rating": 3.5,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/81fFsHY2JdL._AC_UY218_.jpg",
                            "best_seller": false,
                            "price_upper": 0,
                            "is_sponsored": true,
                            "manufacturer": "Astin S  | Apr 26, 2022",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 2,
                            "url": "/gp/slredirect/picassoRedirect.html/ref=pa_sp_atf_aps_sr_pg1_1?ie=UTF8&adId=A05294781PHT6R7DVJVJB&url=/Pokemon-Shining-Pearl-Nintendo-Switch/dp/B096W29KXB/ref=sr_1_2_sspa?keywords=nintendo&qid=1652079433&sr=8-2-spons&psc=1&smid=A1KWJVS57NX03I&qualifier=1652079433&id=2653787596297387&widgetName=sp_atf",
                            "asin": "B096W29KXB",
                            "price": 49.37,
                            "title": "Pokemon Shining Pearl (Nintendo Switch)",
                            "rating": 4.8,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/81w9g65CpxL._AC_UY218_.jpg",
                            "best_seller": false,
                            "price_upper": 49.37,
                            "is_sponsored": true,
                            "manufacturer": "Nintendo",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 11,
                            "url": "/gp/slredirect/picassoRedirect.html/ref=pa_sp_mtf_aps_sr_pg1_1?ie=UTF8&adId=A0247687180QU90F25201&url=/Console-Classic-Wireless-Controller-Children/dp/B09X1Q9ZMC/ref=sr_1_11_sspa?keywords=nintendo&qid=1652079433&sr=8-11-spons&psc=1&qualifier=1652079433&id=2653787596297387&widgetName=sp_mtf",
                            "asin": "B09X1Q9ZMC",
                            "price": 46.99,
                            "title": "Retro Game Console with 620 Video Games,Classic Mini Game System with Wireless Controller,AV and HDMI Output Plug and Play,Retro Toys Gifts Choice for Children and Adults.",
                            "rating": 0,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/71Nh+cufGhL._AC_UY218_.jpg",
                            "best_seller": false,
                            "price_upper": 46.99,
                            "is_sponsored": true,
                            "manufacturer": "",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 16,
                            "url": "/gp/slredirect/picassoRedirect.html/ref=pa_sp_mtf_aps_sr_pg1_1?ie=UTF8&adId=A0782566D0USD5V6QUMQ&url=/Detachable-EUROA-Bluetooth-Headphones-Microphone/dp/B098H3TBTB/ref=sr_1_16_sspa?keywords=nintendo&qid=1652079433&sr=8-16-spons&psc=1&qualifier=1652079433&id=2653787596297387&widgetName=sp_mtf",
                            "asin": "B098H3TBTB",
                            "price": 59.99,
                            "title": "3D Haptic Vibration Wireless Gaming Headset Compatible with Nintendo Switch/PS5/PS4/PC with 3.5 MM Detachable Mic, EUROA Bluetooth Foldable Headphones with Mute Microphone, 50FT Range,40H Play Time",
                            "rating": 4.3,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/71AAuJqAt9L._AC_UY218_.jpg",
                            "best_seller": false,
                            "price_upper": 59.99,
                            "is_sponsored": true,
                            "manufacturer": "",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 21,
                            "url": "/gp/slredirect/picassoRedirect.html/ref=pa_sp_btf_aps_sr_pg1_1?ie=UTF8&adId=A02718462XOHMUWG6NFXC&url=/Classic-NES-Handheld-Controllers-Nintendo-Super/dp/B096QTT4P1/ref=sr_1_21_sspa?keywords=nintendo&qid=1652079433&sr=8-21-spons&psc=1&qualifier=1652079433&id=2653787596297387&widgetName=sp_btf",
                            "asin": "B096QTT4P1",
                            "price": 42.99,
                            "title": "Retro Game Console,Classic Handheld Mini Game System with Built-in 620 Classic Edition Games and 2 Controllers,AV and HDMI Output Video Games for Kids and Adults.",
                            "rating": 3.7,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/71eBIwQl-kL._AC_UY218_.jpg",
                            "best_seller": false,
                            "price_upper": 42.99,
                            "is_sponsored": true,
                            "manufacturer": "",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 22,
                            "url": "/gp/slredirect/picassoRedirect.html/ref=pa_sp_btf_aps_sr_pg1_1?ie=UTF8&adId=A08453061G6DN9ZA2L3MP&url=/Switch-Docking-Station-Nintendo-Replacement/dp/B09K4WVZL7/ref=sr_1_22_sspa?keywords=nintendo&qid=1652079433&sr=8-22-spons&psc=1&qualifier=1652079433&id=2653787596297387&widgetName=sp_btf",
                            "asin": "B09K4WVZL7",
                            "price": 25.98,
                            "title": "Switch Docking Station for Nintendo Switch, TV Dock Station Replacement with HDMI and USB 3.0 Port for Nintendo Switch and OLED Model",
                            "rating": 3.8,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/71kEdN6x5qL._AC_UY218_.jpg",
                            "best_seller": false,
                            "price_upper": 25.98,
                            "is_sponsored": true,
                            "manufacturer": "",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        }
                    ],
                    "organic": [
                        {
                            "pos": 3,
                            "url": "/Nintendo-eShop-Gift-Card-Digital/dp/B01M1VX5UJ/ref=sr_1_3?keywords=nintendo&qid=1652079433&sr=8-3",
                            "asin": "B01M1VX5UJ",
                            "price": 44.99,
                            "title": "$50 Nintendo eShop Gift Card [Digital Code]",
                            "rating": 4.7,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/716sRklLf2L._AC_UY218_.jpg",
                            "best_seller": false,
                            "price_upper": 44.99,
                            "is_sponsored": false,
                            "manufacturer": "Nintendo",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 4,
                            "url": "/Nintendo-Switch-Neon-Blue-Joy‑/dp/B07VGRJDFY/ref=sr_1_4?keywords=nintendo&qid=1652079433&sr=8-4",
                            "asin": "B07VGRJDFY",
                            "price": 299.99,
                            "title": "Nintendo Switch with Neon Blue and Neon Red Joy‑Con - HAC-001(-01)",
                            "rating": 4.8,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/61-PblYntsL._AC_UY218_.jpg",
                            "best_seller": true,
                            "price_upper": 299.99,
                            "is_sponsored": false,
                            "manufacturer": "",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 5,
                            "url": "/Nintendo-Switch-Sports/dp/B09KRK6C82/ref=sr_1_5?keywords=nintendo&qid=1652079433&sr=8-5",
                            "asin": "B09KRK6C82",
                            "price": 49.88,
                            "title": "Nintendo Switch Sports - Nintendo Switch",
                            "rating": 4.5,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/61WA1YOg4lL._AC_UY218_.jpg",
                            "best_seller": true,
                            "price_upper": 49.88,
                            "is_sponsored": false,
                            "manufacturer": "Nintendo",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 6,
                            "url": "/Nintendo-eShop-Gift-Card-Digital/dp/B01LYOCVZF/ref=sr_1_6?keywords=nintendo&qid=1652079433&sr=8-6",
                            "asin": "B01LYOCVZF",
                            "price": 20,
                            "title": "$20 Nintendo eShop Gift Card [Digital Code]",
                            "rating": 4.7,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/71YSvFcuK7L._AC_UY218_.jpg",
                            "best_seller": false,
                            "price_upper": 20,
                            "is_sponsored": false,
                            "manufacturer": "Nintendo",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 7,
                            "url": "/Nintendo-Switch-OLED-Model-White-Joy/dp/B098RKWHHZ/ref=sr_1_7?keywords=nintendo&qid=1652079433&sr=8-7",
                            "asin": "B098RKWHHZ",
                            "price": 349.99,
                            "title": "Nintendo Switch – OLED Model w/ White Joy-Con",
                            "rating": 4.9,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/51YLbkYOhlL._AC_UY218_.jpg",
                            "best_seller": false,
                            "price_upper": 349.99,
                            "is_sponsored": false,
                            "manufacturer": "Nintendo",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 8,
                            "url": "/Nintendo-Switch-Lite-Blue/dp/B092VT1JGD/ref=sr_1_8?keywords=nintendo&qid=1652079433&sr=8-8",
                            "asin": "B092VT1JGD",
                            "price": 199,
                            "title": "Nintendo Switch Lite - Blue",
                            "rating": 4.8,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/61gndBOP9zS._AC_UY218_.jpg",
                            "best_seller": false,
                            "price_upper": 199,
                            "is_sponsored": false,
                            "manufacturer": "Nintendo",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 9,
                            "url": "/Nintendo-eShop-Gift-Card-Digital/dp/B01LZZ8UKK/ref=sr_1_9?keywords=nintendo&qid=1652079433&sr=8-9",
                            "asin": "B01LZZ8UKK",
                            "price": 70,
                            "title": "$70 Nintendo eShop Gift Card [Digital Code]",
                            "rating": 4.7,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/714oSJ60A9L._AC_UY218_.jpg",
                            "best_seller": false,
                            "price_upper": 70,
                            "is_sponsored": false,
                            "manufacturer": "Nintendo",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 10,
                            "url": "/Nintendo-Joy-Neon-Pink-Green-switch/dp/B078GZM4H8/ref=sr_1_10?keywords=nintendo&qid=1652079433&sr=8-10",
                            "asin": "B078GZM4H8",
                            "price": 79.99,
                            "title": "Nintendo Joy-Con (L/R) - Neon Pink / Neon Green",
                            "rating": 4.8,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/61gAv5rkK3L._AC_UY218_.jpg",
                            "best_seller": false,
                            "price_upper": 79.99,
                            "is_sponsored": false,
                            "manufacturer": "Nintendo",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 12,
                            "url": "/Nintendo-Switch-OLED-Model-White/dp/B098TVDYZ3/ref=sr_1_12?keywords=nintendo&qid=1652079433&sr=8-12",
                            "asin": "B098TVDYZ3",
                            "price": 0,
                            "title": "Nintendo Switch (OLED Model) - White",
                            "rating": 4.7,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/51K6gw94TRL._AC_UY218_.jpg",
                            "best_seller": false,
                            "price_upper": 0,
                            "is_sponsored": false,
                            "manufacturer": "Nintendo",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 13,
                            "url": "/Nintendo-eShop-Gift-Card-Digital/dp/B01LZNGH6L/ref=sr_1_13?keywords=nintendo&qid=1652079433&sr=8-13",
                            "asin": "B01LZNGH6L",
                            "price": 35,
                            "title": "$35 Nintendo eShop Gift Card [Digital Code]",
                            "rating": 4.7,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/71kYjm-EI8L._AC_UY218_.jpg",
                            "best_seller": false,
                            "price_upper": 35,
                            "is_sponsored": false,
                            "manufacturer": "Nintendo",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 14,
                            "url": "/Nintendo-eShop-Gift-Card-Digital/dp/B01LZNGPY3/ref=sr_1_14?keywords=nintendo&qid=1652079433&sr=8-14",
                            "asin": "B01LZNGPY3",
                            "price": 10,
                            "title": "$10 Nintendo eShop Gift Card [Digital Code]",
                            "rating": 4.7,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/71g8qy0R8zL._AC_UY218_.jpg",
                            "best_seller": false,
                            "price_upper": 10,
                            "is_sponsored": false,
                            "manufacturer": "Nintendo",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 15,
                            "url": "/Nintendo-Switch-Lite-Turquoise/dp/B07V4GCFP9/ref=sr_1_15?keywords=nintendo&qid=1652079433&sr=8-15",
                            "asin": "B07V4GCFP9",
                            "price": 199,
                            "title": "Nintendo Switch Lite - Turquoise",
                            "rating": 4.8,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/71qmF0FHj7L._AC_UY218_.jpg",
                            "best_seller": false,
                            "price_upper": 199,
                            "is_sponsored": false,
                            "manufacturer": "",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 17,
                            "url": "/Nintendo-Switch-32GB-Video-Game-Console/dp/B08LNY42BL/ref=sr_1_17?keywords=nintendo&qid=1652079433&sr=8-17",
                            "asin": "B08LNY42BL",
                            "price": 184.97,
                            "title": "Nintendo Switch 32GB Video Game Console - Black (HAC-001) / CONSOLE ONLY (Renewed)",
                            "rating": 4.1,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/315s9z7zrKL._AC_UY218_.jpg",
                            "best_seller": false,
                            "price_upper": 184.97,
                            "is_sponsored": false,
                            "manufacturer": "Amazon Renewed",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 18,
                            "url": "/Ecash-Nintendo-Eshop-Switch-Digital/dp/B079C4Q1F7/ref=sr_1_18?keywords=nintendo&qid=1652079433&sr=8-18",
                            "asin": "B079C4Q1F7",
                            "price": 99,
                            "title": "$99 Nintendo eShop Gift Card [Digital Code]",
                            "rating": 4.7,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/71I1bnzOg8L._AC_UY218_.jpg",
                            "best_seller": false,
                            "price_upper": 99,
                            "is_sponsored": false,
                            "manufacturer": "Nintendo",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 19,
                            "url": "/Mario-Kart-Deluxe-Nintendo-Digital/dp/B06Y5VQMKK/ref=sr_1_19?keywords=nintendo&qid=1652079433&sr=8-19",
                            "asin": "B06Y5VQMKK",
                            "price": 59.88,
                            "title": "Mario Kart 8 Deluxe - Nintendo Switch [Digital Code]",
                            "rating": 4.8,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/81QrtG0Uw0L._AC_UY218_.jpg",
                            "best_seller": false,
                            "price_upper": 59.88,
                            "is_sponsored": false,
                            "manufacturer": "Nintendo",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        },
                        {
                            "pos": 20,
                            "url": "/Pokemon-Legends-Arceus-Nintendo-Switch/dp/B0914YGQSH/ref=sr_1_20?keywords=nintendo&qid=1652079433&sr=8-20",
                            "asin": "B0914YGQSH",
                            "price": 58.59,
                            "title": "Pokémon Legends: Arceus - Nintendo Switch",
                            "rating": 4.8,
                            "currency": "USD",
                            "url_image": "https://m.media-amazon.com/images/I/71HYKF4rO9L._AC_UY218_.jpg",
                            "best_seller": false,
                            "price_upper": 58.59,
                            "is_sponsored": false,
                            "manufacturer": "Nintendo",
                            "pricing_count": 1,
                            "reviews_count": 0,
                            "is_amazons_choice": false
                        }
                    ],
                    "suggested": [],
                    "amazons_choices": [],
                    "instant_recommendations": []
                },
                "parse_status_code": 12000,
                "total_results_count": 10000
            },
            "created_at": "2022-05-09 06:57:11",
            "updated_at": "2022-05-09 06:57:15",
            "page": 1,
            "url": "https://www.amazon.com/s?k=nintendo&page=1",
            "job_id": "6929323369774993409",
            "status_code": 200,
            "parser_type": ""
        }
    ]
}

Data dictionary

API returns a HTML or JSON object that contains the search results retrieved from the Amazon.

HTML example

JSON structure

All search results are contained within the results JSON array. Each search result includes a combination of paid, organic, suggested, amazons_choices,instant_recommendations listings. Additionally, variations may be present, and they are captured within the variations key, providing details about different types or categories of products, such as various models, editions, or versions.

Key Description Type

Key	Description	Type
`url`	The URL of the Amazon search page.	string
`page`	The current page number.	integer
`pages`	The total number of pages.	integer
`query`	The search query used.	string
`results`	A dictionary containing the results of the search.	object
`results.paid`	A list of sponsored products with their respective details.	array
`results.organic`	A list of organic products with their respective details.	array
`results.suggested`	A list of suggested products with their respective details.	array
`results.amazons_choices`	A list of Amazon's choices with their respective details.	array
`results.instant_recommendations`	A list of instant recommendations with their respective details.	array
`parse_status_code`	The status code of the parsing job. You can see the parser status codes described here.	integer
`total_results_count`	The total number of results found for the search query.	integer
`created_at`	The timestamp when the scraping job was created.	string
`updated_at`	The timestamp when the scraping job was finished.	string
`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

url

The URL of the Amazon search page.

string

page

The current page number.

integer

pages

The total number of pages.

integer

query

The search query used.

string

results

A dictionary containing the results of the search.

object

results.paid

A list of sponsored products with their respective details.

array

results.organic

A list of organic products with their respective details.

array

results.suggested

A list of suggested products with their respective details.

array

results.amazons_choices

A list of Amazon's choices with their respective details.

array

results.instant_recommendations

A list of instant recommendations with their respective details.

array

parse_status_code

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

integer

total_results_count

The total number of results found for the search query.

integer

created_at

The timestamp when the scraping job was created.

string

updated_at

The timestamp when the scraping job was finished.

string

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.

Paid

The paid section of the search results refers to inline ad content that is displayed within the Amazon search results.

...
"paid": [
    {
        "pos": 1,
        "url": "/sspa/click?ie=UTF8&spc=MTo3ODk3NzcxNTI0MDAzNjk1OjE3MDEwODYyODI6c3BfYXRmOjMwMDA5Mjg4ODc1NTcwMjo6MDo6&url=/IOGEAR-KeyMander-Controller-Crossover-GE1337P2/dp/B08541QCKJ/ref=sr_1_1_sspa?keywords=nintendo&qid=1701086282&sr=8-1-spons&sp_csd=d2lkZ2V0TmFtZT1zcF9hdGY&psc=1"","asin": "B08541QCKJ","price": 69.99,
        "title": "IOGEAR KeyMander 2 Keyboard/Mouse Adapter Plus Controller Crossover, PS4, PS5, Xbox Series X/S, Xbox One, Nintendo Switch, GE1337P2, FPS, mouse control",
        "rating": 3.7,
        "currency": "USD",
        "is_prime": true,
        "url_image": "https://m.media-amazon.com/images/I/41-AZ8CCl1L._AC_UY218_.jpg",
        "best_seller": false,
        "price_upper": 69.99,
        "is_sponsored": true,
        "manufacturer": "",
        "pricing_count": 1,
        "reviews_count": 1229,
        "is_amazons_choice": false,
        "price_strikethrough": 99.95,
        "shipping_information": "FREE delivery Sun, Dec 3 Or fastest delivery Thu, Nov 30"
    },
    ...
]

Key Description Type

Key	Description	Type
`url`	The URL of the product.	string
`asin`	Amazon Standard Identification Number.	string
`price`	The price of the product.	float
`title`	The title of the product.	string
`rating`	The rating of the product.	float
`rel_pos`	The relative position of the product in the search results. (either `pos` or `rel_pos` is present)	integer
`pos`	A unique indicator denoting the position in the listing. (either `pos` or `rel_pos` is present)	integer
`currency`	The currency in which the price is denominated.	string
`url_image`	The URL of the product image.	string
`best_seller`	Indicates whether the product is a best seller.	boolean
`price_upper`	The upper limit of the price if applicable.	float
`is_sponsored`	Indicates whether the product is sponsored.	boolean
`manufacturer`	The name of the manufacturer of the product.	string
`pricing_count`	The count of offers for the product.	integer
`reviews_count`	The count of reviews for the product.	integer
`is_amazons_choice`	Indicates whether the product is marked as “Amazon's choice”.	boolean
`no_price_reason`	Indicator why the price is not present, if it’s equal to 0.0	string (optional)
`sales_volume`	The sales volume or number of units sold for a particular product.	string (optional)
`is_prime`	Indicates whether the product is eligible for Amazon Prime.	boolean
`shipping_information`	Information about the shipping details for the produc	string

url

The URL of the product.

string

asin

Amazon Standard Identification Number.

string

price

The price of the product.

float

title

The title of the product.

string

rating

The rating of the product.

float

rel_pos

The relative position of the product in the search results.

(either pos or rel_pos is present)

integer

pos

A unique indicator denoting the position in the listing. (either pos or rel_pos is present)

integer

currency

The currency in which the price is denominated.

string

url_image

The URL of the product image.

string

best_seller

Indicates whether the product is a best seller.

boolean

price_upper

The upper limit of the price if applicable.

float

is_sponsored

Indicates whether the product is sponsored.

boolean

manufacturer

The name of the manufacturer of the product.

string

pricing_count

The count of offers for the product.

integer

reviews_count

The count of reviews for the product.

integer

is_amazons_choice

Indicates whether the product is marked as “Amazon's choice”.

boolean

no_price_reason

Indicator why the price is not present, if it’s equal to 0.0

string (optional)

sales_volume

The sales volume or number of units sold for a particular product.

string (optional)

is_prime

Indicates whether the product is eligible for Amazon Prime.

boolean

shipping_information

Information about the shipping details for the produc

string

Organic

The organic section of the search results refers to non-sponsored content that appears naturally based on Amazon's search algorithm.

...
"organic": [
    {
        "pos": 3,
        "url": "/Nintendo-eShop-Gift-Card-Digital/dp/B01LYOCVZF/ref=sr_1_3?keywords=nintendo&qid=1701086282&sr=8-3",
        "asin": "B01LYOCVZF",
        "price": 20,
        "title": "$20 Nintendo eShop Gift Card [Digital Code]",
        "rating": 4.7,
        "currency": "USD",
        "is_prime": false,
        "url_image": "https://m.media-amazon.com/images/I/71cj5cNm7ZL._AC_UY218_.jpg"
    },
    ...
]

Name Description Type

Name	Description	Type
`pos`	A unique indicator denoting the position in the listing.	integer
`url`	The URL of the product.	string
`asin`	Amazon Standard Identification Number.	string
`price`	The price of the product.	float
`title`	The title of the product.	string
`rating`	The rating of the product.	float
`currency`	The currency in which the price is denominated.	string
`url_image`	The URL of the product image.	string
`best_seller`	Indicates whether the product is a best seller.	boolean
`price_upper`	The upper limit of the price if applicable.	float
`is_sponsored`	Indicates whether the product is sponsored.	boolean
`manufacturer`	The name of the manufacturer of the product.	string
`pricing_count`	The count of pricings for the product.	integer
`reviews_count`	The count of reviews for the product.	integer
`is_amazons_choice`	Indicates whether the product is Amazon's choice.	boolean
`no_price_reason`	Indicator why the price is not present, if it’s equal to 0.0	string(optional)
`is_prime`	Indicates whether the product is eligible for Amazon Prime.	boolean
`sales_volume`	The sales volume or number of units sold for a particular product.	string(optional)
`variations`	List of different versions or models of a product	Array

pos

A unique indicator denoting the position in the listing.

integer

url

The URL of the product.

string

asin

Amazon Standard Identification Number.

string

price

The price of the product.

float

title

The title of the product.

string

rating

The rating of the product.

float

currency

The currency in which the price is denominated.

string

url_image

The URL of the product image.

string

best_seller

Indicates whether the product is a best seller.

boolean

price_upper

The upper limit of the price if applicable.

float

is_sponsored

Indicates whether the product is sponsored.

boolean

manufacturer

The name of the manufacturer of the product.

string

pricing_count

The count of pricings for the product.

integer

reviews_count

The count of reviews for the product.

integer

is_amazons_choice

Indicates whether the product is Amazon's choice.

boolean

no_price_reason

Indicator why the price is not present, if it’s equal to 0.0

string(optional)

is_prime

Indicates whether the product is eligible for Amazon Prime.

boolean

sales_volume

The sales volume or number of units sold for a particular product.

string(optional)

variations

List of different versions or models of a product

Array

Suggested

The suggested section in the search results typically contains product listings recommended by the platform based on the user's search query, browsing history, or purchase behavior.

...
"suggested": [
    {
        "pos": 3,
        "asin": "B07L4ZRJ7P",
        "best_seller": false,
        "is_sponsored": false,
        "is_amazons_choice": false,
        "manufacturer": "",
        "pricing_count": 1,
        "rating": 4.0,
        "reviews_count": 1,
        "title": "The Supercar Story",
        "url": "/Supercar-Story-Patrick-Mark/dp/B07L4ZRJ7P/ref=sr_1_fkmr0_1?keywords=details+about+mercedes+benz+head+unit+e-class+w213+comand+navi+gps+unit+a21390050813&qid=1636460216&sr=8-1-fkmr0",
        "url_image": "https://m.media-amazon.com/images/I/81uC-IclZqL._AC_UY218_.jpg",
        "is_prime": false,
        "price": 0.0,
        "price_upper": 0.0,
        "no_price_reason": "unknown",
        "pos": 1,
        "currency": "USD",
        "suggested_query": "details benz head"
    },
    ...
]

Key Description Type

Key	Description	Type
`url`	The URL of the product.	string
`asin`	Amazon Standard Identification Number.	string
`price`	The price of the product.	float
`title`	The title of the product.	string
`rating`	The rating of the product.	float
`currency`	The currency in which the price is denominated.	string
`url_image`	The URL of the product image.	string
`best_seller`	Indicates whether the product is a best seller.	boolean
`price_upper`	The upper limit of the price if applicable.	float
`is_sponsored`	Indicates whether the product is sponsored.	boolean
`manufacturer`	The name of the manufacturer of the product.	string
`pricing_count`	The count of pricing for the product.	integer
`reviews_count`	The count of reviews for the product.	integer
`is_amazons_choice`	Indicates whether the product is Amazon's choice.	boolean
`pos`	A unique indicator denoting the position in the listing.	integer
`is_prime`	Indicates whether the product is eligible for Amazon Prime.	boolean
`shipping_information`	Information about the shipping details for the product.	string
`sales_volume`	The sales volume or number of units sold for a particular product.	string(optional)
`no_price_reason`	Indicator why the price is not present, if it’s equal to 0.0	string(optional)
`suggested_query`	The suggested query provided by Amazon as part of the search results.	string

url

The URL of the product.

string

asin

Amazon Standard Identification Number.

string

price

The price of the product.

float

title

The title of the product.

string

rating

The rating of the product.

float

currency

The currency in which the price is denominated.

string

url_image

The URL of the product image.

string

best_seller

Indicates whether the product is a best seller.

boolean

price_upper

The upper limit of the price if applicable.

float

is_sponsored

Indicates whether the product is sponsored.

boolean

manufacturer

The name of the manufacturer of the product.

string

pricing_count

The count of pricing for the product.

integer

reviews_count

The count of reviews for the product.

integer

is_amazons_choice

Indicates whether the product is Amazon's choice.

boolean

pos

A unique indicator denoting the position in the listing.

integer

is_prime

Indicates whether the product is eligible for Amazon Prime.

boolean

shipping_information

Information about the shipping details for the product.

string

sales_volume

The sales volume or number of units sold for a particular product.

string(optional)

no_price_reason

Indicator why the price is not present, if it’s equal to 0.0

string(optional)

suggested_query

The suggested query provided by Amazon as part of the search results.

string

Amazon's Choices

The amazons_choices section features products with 'Amazon's Choice' badge and are recommended by the platform for their perceived quality and value.

...
"amazons_choices": [
    {
        "asin": "B07STGGQ18",
        "best_seller": false,
        "is_sponsored": false,
        "is_amazons_choice": true,
        "manufacturer": "",
        "pricing_count": 1,
        "rating": 4.8,
        "reviews_count": 9,
        "title": "AMD Ryzen 5 3600 4, 2GHz AM4 35MB Cache Wraith Stealth",
        "url": "/AMD-Ryzen-3600-Wraith-Stealth/dp/B07STGGQ18/ref=sr_1_3?dchild=1&keywords=0730143309936&qid=1600153905&sr=8-3",
        "url_image": "https://m.media-amazon.com/images/I/71WPGXQLcLL._AC_UY218_.jpg",
        "is_prime": true,
        "price": 179.0,
        "price_upper": 179.0,
        "shipping_information": "Lieferung bis Freitag, 18. September GRATIS Versand durch Amazon",
        "pos": 3,
        "currency": "EUR"
    },
    ...
]

Key Description Type

Key	Description	Type
`url`	The URL of the product.	string
`asin`	Amazon Standard Identification Number.	string
`price`	The price of the product.	float
`title`	The title of the product.	string
`rating`	The rating of the product.	float
`currency`	The currency in which the price is denominated.	string
`url_image`	The URL of the product image.	string
`best_seller`	Indicates whether the product is a best seller.	boolean
`price_upper`	The upper limit of the price if applicable.	float
`is_sponsored`	Indicates whether the product is sponsored.	boolean
`manufacturer`	The name of the manufacturer of the product.	string
`pricing_count`	The count of pricing for the product.	integer
`reviews_count`	The count of reviews for the product.	integer
`is_amazons_choice`	Indicates whether the product is Amazon's choice.	boolean
`pos`	A unique indicator denoting the position in the listing.	integer
`is_prime`	Indicates whether the product is eligible for Amazon Prime.	boolean
`shipping_information`	Information about the shipping details for the product.	string
`sales_volume`	The sales volume or number of units sold for a particular product.	string(optional)
`no_price_reason`	Indicator why the price is not present, if it’s equal to 0.0	string(optional)
`variations`	List of different versions or models of a product	Array

url

The URL of the product.

string

asin

Amazon Standard Identification Number.

string

price

The price of the product.

float

title

The title of the product.

string

rating

The rating of the product.

float

currency

The currency in which the price is denominated.

string

url_image

The URL of the product image.

string

best_seller

Indicates whether the product is a best seller.

boolean

price_upper

The upper limit of the price if applicable.

float

is_sponsored

Indicates whether the product is sponsored.

boolean

manufacturer

The name of the manufacturer of the product.

string

pricing_count

The count of pricing for the product.

integer

reviews_count

The count of reviews for the product.

integer

is_amazons_choice

Indicates whether the product is Amazon's choice.

boolean

pos

A unique indicator denoting the position in the listing.

integer

is_prime

Indicates whether the product is eligible for Amazon Prime.

boolean

shipping_information

Information about the shipping details for the product.

string

sales_volume

The sales volume or number of units sold for a particular product.

string(optional)

no_price_reason

Indicator why the price is not present, if it’s equal to 0.0

string(optional)

variations

List of different versions or models of a product

Array

Instant Recommendations

The instant_recommendations section may include products that are suggested to users based on their current search or viewing activity in real-time.

...
"instant_recommendations": [
    {
        "asin": "B004Q5FSFC",
        "best_seller": false,
        "is_sponsored": false,
        "is_amazons_choice": false,
        "manufacturer": "",
        "pricing_count": 1,
        "rating": 4.4,
        "reviews_count": 2583,
        "title": "BabyPrem 2 Moses Basket Sheets Fitted White Cotton",
        "url": "/dp/B004Q5FSFC/ref=sxbs_sbl_swb_0?pd_rd_w=LVYjW&pf_rd_p=50b422af-ccd5-4019-befd-3f6948bd35a6&pf_rd_r=A56P28D64SR0C4MGA9H9&pd_rd_r=40560bcc-28a9-4fdb-bbc4-5fcd00496323&pd_rd_wg=ztuOU&pd_rd_i=B004Q5FSFC",
        "url_image": "https://images-na.ssl-images-amazon.com/images/G/01/x-locale/common/grey-pixel.gif",
        "price": 12.99,
        "price_upper": 12.99,
        "pos": 65,
        "currency": "USD"
    },
    ...
]

Key Description Type

Key	Description	Type
`url`	The URL of the product.	string
`asin`	Amazon Standard Identification Number.	string
`price`	The price of the product.	float
`title`	The title of the product.	string
`rating`	The rating of the product.	float
`currency`	The currency in which the price is denominated.	string
`url_image`	The URL of the product image.	string
`best_seller`	Indicates whether the product is a best seller.	boolean
`price_upper`	The upper limit of the price if applicable.	float
`is_sponsored`	Indicates whether the product is sponsored.	boolean
`manufacturer`	The name of the manufacturer of the product.	string
`pricing_count`	The count of pricings for the product.	integer
`reviews_count`	The count of reviews for the product.	integer
`is_amazons_choice`	Indicates whether the product is Amazon's choice.	boolean
`pos`	A unique indicator denoting the position in the listing.	integer
`sales_volume`	The sales volume or number of units sold for a particular product.	string(optional)
`no_price_reason`	Indicator why the price is not present, if it’s equal to 0.0	string(optional)

url

The URL of the product.

string

asin

Amazon Standard Identification Number.

string

price

The price of the product.

float

title

The title of the product.

string

rating

The rating of the product.

float

currency

The currency in which the price is denominated.

string

url_image

The URL of the product image.

string

best_seller

Indicates whether the product is a best seller.

boolean

price_upper

The upper limit of the price if applicable.

float

is_sponsored

Indicates whether the product is sponsored.

boolean

manufacturer

The name of the manufacturer of the product.

string

pricing_count

The count of pricings for the product.

integer

reviews_count

The count of reviews for the product.

integer

is_amazons_choice

Indicates whether the product is Amazon's choice.

boolean

pos

A unique indicator denoting the position in the listing.

integer

sales_volume

The sales volume or number of units sold for a particular product.

string(optional)

no_price_reason

Indicator why the price is not present, if it’s equal to 0.0

string(optional)

Variations

The variations section lists different versions or models of a product, providing a detailed overview of available options in the specified category.

...
"variations": [
  {
    "asin": "B08KXB6SZH",
    "title": "PlayStation 5",
    "price": 29.99,
    "not_available": false
  },
  {
    "asin": "B08L6FZM6D",
    "title": "PlayStation 4",
    "not_available": false,
    "no_price_reason": "unknown"
  },
  {
    "asin": "B08N766Q9W",
    "title": "Xbox Digial Code",
    "not_available": true,
    "no_price_reason": "Currently unavailable."
  }
],
...

Key Description Type

Key	Description	Type
`asin`	Amazon Standard Identification Number	string
`title`	Title of the variation	string
`price`	Price of the variation	float
`price_strikethrough`	The original price before any discounts or promotions	float
`not_available`	Indicates if the variation is currently unavailable	boolean

asin

Amazon Standard Identification Number

string

title

Title of the variation

string

price

Price of the variation

float

price_strikethrough

The original price before any discounts or promotions

float