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

Request samples

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.

cURL

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-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": "16391693031"
            }
        ]
    }'

Python

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=('USERNAME', 'PASSWORD'),
    json=payload,
)

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

Node.js

const https = require("https");

const username = "USERNAME";
const password = "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 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();

HTTP

https://realtime.oxylabs.io/v1/queries?source=amazon_search&domain=nl&query=nirvana%20tshirt&start_page=2&pages=2&parse=true&context[0][key]=category_id&context[0][value]=16391693031&access_token=12345abcde

PHP

<?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, "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);

Golang

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

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 = "USERNAME";
            const string Password = "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);
        }
    }
}

Java

package org.example;

import okhttp3.*;
import org.json.JSONArray;
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_search");
        jsonObject.put("domain", "nl");
        jsonObject.put("query", "nirvana tshirt");
        jsonObject.put("start_page", 2);
        jsonObject.put("pages", 2);
        jsonObject.put("parse", true);
        jsonObject.put("context", new JSONArray().put(
                new JSONObject()
                        .put("key", "category_id")
                        .put("value", "16391693031")
        ));

        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();
    }
}

JSON

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

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

Parameter	Description	Default Value
source	Sets the scraper.	amazon_search
query	UTF-encoded keyword.	-
render	Enables JavaScript rendering when set to html. More info.	-
parse	Returns parsed data when set to true. Explore output data dictionary.	false
callback_url	URL to your callback endpoint. More info.	-
user_agent_type	Device type and browser. The full list can be found here.	desktop

- mandatory parameter

Localization

Adapt results to specific geographical locations, domains, languages.

Parameter	Description	Default Value
geo_location	The Deliver to location. See our guide to using this parameter here.	-
domain	Domain localization for Bestbuy. The full list of available domains can be found here.	com
locale	Accept-Language header value, which sets the interface language of the Amazon page. More info.	-

IMPORTANT: On most page types, Amazon tailors the returned results based on the delivery location of their customers. Therefore, we advise using the geo_location parameter to set your preferred delivery location. You can read more about using geo_location with Amazon here.

Pagination

Controls for managing the pagination and retrieval of search results.

Parameter	Description	Default Value
start_page	Starting page number.	1
pages	Number of pages to retrieve.	1

Other

Additional advanced settings and controls for specialized requirements.

Parameter	Description	Default Value
context: category_id	Search for items in a particular browse node (product category).	-
context: merchant_id	Search for items sold by a particular seller.	-
context: currency	Sets the currency. Check the available values here.	Depends on the marketplace. Check the default values here.

Code example

{
    "source": "amazon_search",
    "domain": "nl",
    "query": "nirvana tshirt",
    "parse": true,
    "context": [
        {
            "key": "currency",
            "value": "AUD"
        }
    ]
}

Structured data

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

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