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

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

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

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

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

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

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

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

{
    "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

PreviousProduct NextPricing

Last updated 9 months ago

Was this helpful?

Good afternoon

Request samples

Request parameter values

Generic

Localization

Pagination

Other

Code example

Structured data

Output data dictionary

HTML example

JSON structure

Paid

Organic

Suggested

Amazon's Choices

Instant Recommendations

Variations