Best Sellers

The amazon_bestsellers data source is designed to retrieve Amazon Best Sellers 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 Best Sellers, 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 the 2nd page of Best Sellers in category, which ID is 172541, on amazon.com marketplace.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "amazon_bestsellers",
        "domain": "com", 
        "query": "172541", 
        "render": "html",
        "start_page": 2, 
        "parse": true
    }'

import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'amazon_bestsellers',
    'domain': 'com',
    'query': '172541',
    'render': 'html',
    'start_page': 2,
    'parse': True,
}


# 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_bestsellers",
    domain: "com",
    query: "172541",
    render: "html",
    start_page: 2, 
    parse: true,
};

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

<?php

$params = array(
    'source' => 'amazon_bestsellers',
    'domain' => 'com',
    'query' => '172541',
    'render' => 'html',
    'start_page' => 2, 
    'parse' => true
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERPWD, "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_bestsellers",
		"domain":     "com",
		"query":      "172541",
		"render":     "html",
		"start_page": 2,
		"parse":      true,
	}

	jsonValue, _ := json.Marshal(payload)

	client := &http.Client{}
	request, _ := http.NewRequest("POST",
		"https://realtime.oxylabs.io/v1/queries",
		bytes.NewBuffer(jsonValue),
	)

	request.SetBasicAuth(Username, Password)
	response, _ := client.Do(request)

	responseText, _ := ioutil.ReadAll(response.Body)
	fmt.Println(string(responseText))
}

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_bestsellers",
                domain = "com",
                query = "172541",
                render = "html",
                start_page = 2,
                parse = true
            };

            var client = new HttpClient();

            Uri baseUri = new Uri("https://realtime.oxylabs.io");
            client.BaseAddress = baseUri;

            var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries");
            requestMessage.Content = JsonContent.Create(parameters);

            var authenticationString = $"{Username}:{Password}";
            var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString));
            requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);

            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();

            Console.WriteLine(contents);
        }
    }
}

package org.example;

import okhttp3.*;
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_bestsellers");
        jsonObject.put("domain", "com");
        jsonObject.put("query", "172541");
        jsonObject.put("render", "html");
        jsonObject.put("start_page", 2);
        jsonObject.put("parse", true);

        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);
            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };

        var client = new OkHttpClient.Builder()
                .authenticator(authenticator)
                .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();
    }
}

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 Best Sellers pages.

Parameter

Description

Default Value

source

Sets the scraper.

amazon_bestsellers

query

Browse node ID.

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 Amazon. 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: currency

Sets the currency. Check the available values here.

Depends on the marketplace. Check the default values here.

Code example

{
    "source": "amazon_bestsellers",
    "domain": "com",
    "query": "172541",
    "parse": true,
    "context": [
        {
            "key": "currency",
            "value": "AUD"
        }
    ]
}

Structured data

Below you can find a structured output example for amazon_bestsellers.

Amazon_bestsellers output example

{
  "results": [
    {
      "content": {
        "url": "https://www.amazon.com/Best-Sellers/zgbs/x/2407760011/?pg=1",
        "page": 1,
        "pages": 2,
        "query": "2407760011",
        "results": [
          {
            "pos": 1,
            "url": "/Hiearcool-Universal-Waterproof-Samsung-Cellphone/dp/B082R2TMRV/ref=zg_bs_2407760011_1/140-4851587-8700940?pd_rd_i=B09KY7BMXF&psc=1",
            "asin": "B082R2TMRV",
            "price": 0,
            "title": "Universal Waterproof Case,Hiearcool Waterproof Phone Pouch Compatible for iPhone 13 12 11 Pro Max XS Max Samsung Galaxy s10 G",
            "rating": 4.6,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 2,
            "url": "/TAURI-iPhone-13-Protector-Protection/dp/B09WJYQY94/ref=zg_bs_2407760011_2/140-4851587-8700940?pd_rd_i=B09PNVCCDF&psc=1",
            "asin": "B09WJYQY94",
            "price": 0,
            "title": "TAURI [3 in 1 Defender Designed for iPhone 13 Pro Max Case 6.7 Inch, with 2 Pack Tempered Glass Screen Protector + 2 Pack Cam",
            "rating": 4.6,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 3,
            "url": "/Mkeke-Compatible-Yellowing-Shockproof-Protective/dp/B09DPG49YB/ref=zg_bs_2407760011_3/140-4851587-8700940?pd_rd_i=B09J3ZVYSX&psc=1",
            "asin": "B09DPG49YB",
            "price": 0,
            "title": "Mkeke Compatible with iPhone 13 Case Black, Not Yellowing Shockproof 13 Phone Black Case with Protective Bumper Slim Fit for ",
            "rating": 4.7,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 4,
            "url": "/CASEKOO-iPhone-13-Pro-Protection/dp/B09WJ1NBHQ/ref=zg_bs_2407760011_4/140-4851587-8700940?pd_rd_i=B09J62TMS5&psc=1",
            "asin": "B09WJ1NBHQ",
            "price": 0,
            "title": "CASEKOO Crystal Clear Designed for iPhone 13 Pro case, [Not Yellowing] [Military Drop Protection] Shockproof Protective Phone",
            "rating": 4.7,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 5,
            "url": "/Spigen-Hybrid-Anti-Yellowing-Technology-Designed/dp/B096J9ZSG1/ref=zg_bs_2407760011_5/140-4851587-8700940?pd_rd_i=B096HLB5WB&psc=1",
            "asin": "B096J9ZSG1",
            "price": 0,
            "title": "Spigen Ultra Hybrid [Anti-Yellowing Technology] Designed for iPhone 13 Pro Max Case (2021) - Crystal Clear",
            "rating": 4.6,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 6,
            "url": "/OtterBox-COMMUTER-Case-iPhone-Plus/dp/B00Z7S33CC/ref=zg_bs_2407760011_6/140-4851587-8700940?pd_rd_i=B08SB2WWM9&psc=1",
            "asin": "B00Z7S33CC",
            "price": 0,
            "title": "OtterBox COMMUTER SERIES Case for iPhone SE (3rd and 2nd gen) and iPhone 8/7 - Retail Packaging - BALLET WAY (PINK SALT/BLUSH",
            "rating": 4.6,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 7,
            "url": "/IMBZBK-Samsung-Galaxy-S22-Ultra/dp/B09NL5BTR8/ref=zg_bs_2407760011_7/140-4851587-8700940?pd_rd_i=B09ZQHPT68&psc=1",
            "asin": "B09NL5BTR8",
            "price": 0,
            "title": "IMBZBK [3+3 Pack] for Samsung Galaxy S22 Ultra 5G Screen Protector [Not Glass], 3 Pack Flexible TPU Film with 3 Pack Tempered",
            "rating": 4.3,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 8,
            "url": "/Cordking-iPhone-11-Shockproof-Anti-Scratch/dp/B091TGTP4S/ref=zg_bs_2407760011_8/140-4851587-8700940?pd_rd_i=B09525CQGL&psc=1",
            "asin": "B091TGTP4S",
            "price": 0,
            "title": "Cordking iPhone 11 Case, Silicone Ultra Slim Shockproof Phone Case with [Soft Anti-Scratch Microfiber Lining], 6.1 inch, Blac",
            "rating": 4.5,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 9,
            "url": "/Cordking-Designed-Shockproof-Anti-Scratch-Microfiber/dp/B08CXZHG4C/ref=zg_bs_2407760011_9/140-4851587-8700940?pd_rd_i=B08MZW4JJ1&psc=1",
            "asin": "B08CXZHG4C",
            "price": 0,
            "title": "Cordking Designed for iPhone 12 Case, Designed for iPhone 12 Pro Case, Silicone Shockproof Phone Case with [Soft Anti-Scratch",
            "rating": 4.5,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 10,
            "url": "/Cordking-iPhone-13-Pro-Anti-Scratch/dp/B09BP2C3G2/ref=zg_bs_2407760011_10/140-4851587-8700940?pd_rd_i=B09FZNRCFY&psc=1",
            "asin": "B09BP2C3G2",
            "price": 0,
            "title": "Cordking Designed for iPhone 13 Pro Case, Silicone Ultra Slim Shockproof Protective Phone Case with [Soft Anti-Scratch Microf",
            "rating": 4.5,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 11,
            "url": "/OtterBox-Commuter-Case-iPhone-Pro/dp/B08DY7D8WZ/ref=zg_bs_2407760011_11/140-4851587-8700940?pd_rd_i=B093721WFT&psc=1",
            "asin": "B08DY7D8WZ",
            "price": 0,
            "title": "OTTERBOX COMMUTER SERIES Case for iPhone 12 & iPhone 12 Pro - BESPOKE WAY (BLAZER BLUE/STORMY SEAS BLUE)",
            "rating": 4.7,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 12,
            "url": "/Mkeke-Compatible-iPhone-Clear-Inch-Black/dp/B081G9JCQ1/ref=zg_bs_2407760011_12/140-4851587-8700940?pd_rd_i=B08HN8SQL1&psc=1",
            "asin": "B081G9JCQ1",
            "price": 0,
            "title": "Mkeke Compatible with iPhone 11 Case, Clear Shock Absorption Cases for 6.1 Inch Black",
            "rating": 4.7,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 13,
            "url": "/OTTERBOX-COMMUTER-Case-iPhone-Pro/dp/B09D55YMC1/ref=zg_bs_2407760011_13/140-4851587-8700940?pd_rd_i=B09NCXVBYH&psc=1",
            "asin": "B09D55YMC1",
            "price": 0,
            "title": "OTTERBOX COMMUTER SERIES Case for iPhone 13 Pro Max & iPhone 12 Pro Max - BLACK",
            "rating": 4.6,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 14,
            "url": "/Elando-Compatible-Non-Yellowing-Shockproof-Protective/dp/B08RNNJN4P/ref=zg_bs_2407760011_14/140-4851587-8700940?pd_rd_i=B09S3R1WSZ&psc=1",
            "asin": "B08RNNJN4P",
            "price": 0,
            "title": "Elando Crystal Clear Case Compatible with iPhone 12/12 Pro, Non-Yellowing Shockproof Protective Phone Case Slim Thin, 6.1 inc",
            "rating": 4.7,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 15,
            "url": "/OTTERBOX-COMMUTER-Case-iPhone-ONLY/dp/B09D51Z5TR/ref=zg_bs_2407760011_15/140-4851587-8700940?pd_rd_i=B09NCWDKKR&psc=1",
            "asin": "B09D51Z5TR",
            "price": 0,
            "title": "OTTERBOX COMMUTER SERIES Case for iPhone 13 (ONLY) - BLACK",
            "rating": 4.7,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 16,
            "url": "/OTTERBOX-SYMMETRY-CLEAR-Case-iPhone/dp/B09D5DCTRH/ref=zg_bs_2407760011_16/140-4851587-8700940?pd_rd_i=B09SF5MR3V&psc=1",
            "asin": "B09D5DCTRH",
            "price": 0,
            "title": "OTTERBOX SYMMETRY CLEAR SERIES Case for iPhone 13 (ONLY) - CLEAR",
            "rating": 4.7,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 17,
            "url": "/Cordking-13-Shockproof-Protective-Anti-Scratch/dp/B09BPSXHN6/ref=zg_bs_2407760011_17/140-4851587-8700940?pd_rd_i=B09FZLH56R&psc=1",
            "asin": "B09BPSXHN6",
            "price": 0,
            "title": "Cordking Designed for iPhone 13 Pro Max Case, Silicone Ultra Slim Shockproof Protective Phone Case with [Soft Anti-Scratch Mi",
            "rating": 4.6,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 18,
            "url": "/TAURI-iPhone-13-Protection-Shockproof/dp/B09C5R18QW/ref=zg_bs_2407760011_18/140-4851587-8700940?pd_rd_i=B09FYSSN53&psc=1",
            "asin": "B09C5R18QW",
            "price": 0,
            "title": "TAURI [3 in 1] Defender Designed for iPhone 13 Case 6.1 Inch, with 2 Pack Tempered Glass Screen Protector + 2 Pack Camera Len",
            "rating": 4.6,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 19,
            "url": "/COOLQO-Compatible-Protector-Shockproof-Protective/dp/B082HQRL1P/ref=zg_bs_2407760011_19/140-4851587-8700940?pd_rd_i=B082HQ38SF&psc=1",
            "asin": "B082HQRL1P",
            "price": 0,
            "title": "COOLQO Compatible for iPhone 11 Case, with [2 x Tempered Glass Screen Protector] Clear 360 Full Body Coverage Hard PC+Soft Si",
            "rating": 4.5,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 20,
            "url": "/SPIDERCASE-Designed-Yellowing-Military-Protection/dp/B09WXVT9R2/ref=zg_bs_2407760011_20/140-4851587-8700940?pd_rd_i=B09XZV8VN8&psc=1",
            "asin": "B09WXVT9R2",
            "price": 0,
            "title": "SPIDERCASE Designed for iPhone 13 Pro Max Case, [Crystal Clear] [Not Yellowing Military Grade Drop Protection] Slim Thin Clea",
            "rating": 4.6,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 21,
            "url": "/OTOFLY-Protection-Anti-Scratch-Shockproof-Compatible/dp/B07XQHDDVQ/ref=zg_bs_2407760011_21/140-4851587-8700940?pd_rd_i=B07XQP2LG9&psc=1",
            "asin": "B07XQHDDVQ",
            "price": 0,
            "title": "OTOFLY iPhone 11 Case,Ultra Slim Fit iPhone Case Liquid Silicone Gel Cover with Full Body Protection Anti-Scratch Shockproof ",
            "rating": 4.5,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 22,
            "url": "/OTTERBOX-SYMMETRY-CLEAR-Case-iPhone/dp/B09D5FPZZW/ref=zg_bs_2407760011_22/140-4851587-8700940?pd_rd_i=B09XJWVF43&psc=1",
            "asin": "B09D5FPZZW",
            "price": 0,
            "title": "OTTERBOX SYMMETRY CLEAR SERIES Case for iPhone 13 Pro (ONLY) - CLEAR",
            "rating": 4.6,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 23,
            "url": "/Cordking-iPhone-13-Shockproof-Anti-Scratch/dp/B09BP234TP/ref=zg_bs_2407760011_23/140-4851587-8700940?pd_rd_i=B09J3Z6S39&psc=1",
            "asin": "B09BP234TP",
            "price": 0,
            "title": "Cordking Designed for iPhone 13 Case, Silicone Ultra Slim Shockproof Protective Phone Case with [Soft Anti-Scratch Microfiber",
            "rating": 4.6,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 24,
            "url": "/JOTO-Universal-Waterproof-Cellphone-Underwater/dp/B07V8HGM7T/ref=zg_bs_2407760011_24/140-4851587-8700940?pd_rd_i=B07WK1ZG9C&psc=1",
            "asin": "B07V8HGM7T",
            "price": 0,
            "title": "JOTO Waterproof Case Universal Phone Holder Pouch, Underwater Cellphone Dry Bag Compatible with iPhone 13 Pro 12 11 Pro Max X",
            "rating": 4.5,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 25,
            "url": "/OTOFLY-Compatible-Silicone-Full-Body-Protective/dp/B08H5T9KM4/ref=zg_bs_2407760011_25/140-4851587-8700940?pd_rd_i=B08H5W88G7&psc=1",
            "asin": "B08H5T9KM4",
            "price": 0,
            "title": "OTOFLY Compatible with iPhone 12 Case and iPhone 12 Pro Case 6.1 inch(2020),[Silky and Soft Touch Series] Premium Soft Liquid",
            "rating": 4.5,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 26,
            "url": "/AEDILYS-Shockproof-iPhone-pro-Case/dp/B09ZTYW5JP/ref=zg_bs_2407760011_26/140-4851587-8700940?pd_rd_i=B09ZTYW5JP&psc=1",
            "asin": "B09ZTYW5JP",
            "price": 0,
            "title": "AEDILYS Shockproof for iPhone 13 pro Case",
            "rating": 0,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 27,
            "url": "/OTTERBOX-COMMUTER-Case-iPhone-ONLY/dp/B09D5PFMDR/ref=zg_bs_2407760011_27/140-4851587-8700940?pd_rd_i=B09NCYK6P4&psc=1",
            "asin": "B09D5PFMDR",
            "price": 0,
            "title": "OTTERBOX COMMUTER SERIES Case for iPhone 13 Pro (ONLY) - BLACK",
            "rating": 4.7,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 28,
            "url": "/Cordking-iPhone-Silicone-Shockproof-Microfiber/dp/B08QFB7N8P/ref=zg_bs_2407760011_28/140-4851587-8700940?pd_rd_i=B08X7L75L8&psc=1",
            "asin": "B08QFB7N8P",
            "price": 0,
            "title": "Cordking iPhone SE Case 2022/2020, iPhone 7 8 Case, Silicone Ultra Slim Shockproof Phone Case with [Soft Microfiber Lining], ",
            "rating": 4.6,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 29,
            "url": "/OTOFLY-Silicone-Full-Body-Protective-Compatible/dp/B07QG5HY9M/ref=zg_bs_2407760011_29/140-4851587-8700940?pd_rd_i=B07QKSYGY4&psc=1",
            "asin": "B07QG5HY9M",
            "price": 0,
            "title": "OTOFLY Compatible with iPhone XR Case,[Silky and Soft Touch Series] Premium Soft Liquid Silicone Rubber Full-Body Protective ",
            "rating": 4.5,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 30,
            "url": "/SPIDERCASE-Waterproof-Protection-Shockproof-Anti-Scratched/dp/B09N3JLG44/ref=zg_bs_2407760011_30/140-4851587-8700940?pd_rd_i=B09XQZBZDL&psc=1",
            "asin": "B09N3JLG44",
            "price": 0,
            "title": "SPIDERCASE for Samsung Galaxy S22 Ultra Case, Waterproof Built-in Screen Protector Full Protection Heavy Duty Shockproof Anti",
            "rating": 4.4,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 31,
            "url": "/JOTO-Universal-Waterproof-Cellphone-Samsung/dp/B00LBK7OSY/ref=zg_bs_2407760011_31/140-4851587-8700940?pd_rd_i=B01ITNRGFG&psc=1",
            "asin": "B00LBK7OSY",
            "price": 0,
            "title": "JOTO Universal Waterproof Phone Pouch Cellphone Dry Bag Case Compatible with iPhone 13 12 11 Pro Max Mini Xs XR X 8 7 6S Plus",
            "rating": 4.5,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 32,
            "url": "/OtterBox-SYMMETRY-Antimicrobial-MagSafe-iPhone/dp/B09LPFQ8LY/ref=zg_bs_2407760011_32/140-4851587-8700940?pd_rd_i=B09MX2XN43&psc=1",
            "asin": "B09LPFQ8LY",
            "price": 0,
            "title": "OtterBox SYMMETRY SERIES+ Antimicrobial Case with MagSafe for iPhone 12/13 Pro Max - Black",
            "rating": 4.4,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 33,
            "url": "/OTTERBOX-SYMMETRY-DISNEYS-50th-iPhone/dp/B09JYLQPGD/ref=zg_bs_2407760011_33/140-4851587-8700940?pd_rd_i=B09NCX976Y&psc=1",
            "asin": "B09JYLQPGD",
            "price": 0,
            "title": "OTTERBOX SYMMETRY SERIES DISNEY'S 50th Case for iPhone 13 Pro Max & iPhone 12 Pro Max - 50th BADGE",
            "rating": 4.8,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 34,
            "url": "/OtterBox-DEFENDER-SCREENLESS-Case-iPhone/dp/B07V1PC86V/ref=zg_bs_2407760011_34/140-4851587-8700940?pd_rd_i=B09SF7C7V8&psc=1",
            "asin": "B07V1PC86V",
            "price": 0,
            "title": "OTTERBOX DEFENDER SERIES SCREENLESS EDITION Case for iPhone 11 - BLACK",
            "rating": 4.7,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 35,
            "url": "/TORRAS-Shockproof-Compatible-Military-Grade-Translucent/dp/B0946Y2ZM6/ref=zg_bs_2407760011_35/140-4851587-8700940?pd_rd_i=B09VZ9VGHJ&psc=1",
            "asin": "B0946Y2ZM6",
            "price": 0,
            "title": "TORRAS Shockproof Compatible for iPhone 13 Pro Case, [Military-Grade Drop Tested] Translucent Matte Hard PC Back with Soft Si",
            "rating": 4.6,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 36,
            "url": "/OtterBox-COMMUTER-Case-iPhone-11/dp/B07W45LYY8/ref=zg_bs_2407760011_36/140-4851587-8700940?pd_rd_i=B07W45LYY8&psc=1",
            "asin": "B07W45LYY8",
            "price": 0,
            "title": "OTTERBOX COMMUTER SERIES Case for iPhone 11 - BLACK",
            "rating": 4.8,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 37,
            "url": "/TAURI-iPhone-13-Pro-Protection/dp/B09C5S9DMM/ref=zg_bs_2407760011_37/140-4851587-8700940?pd_rd_i=B09GYVWBVK&psc=1",
            "asin": "B09C5S9DMM",
            "price": 0,
            "title": "TAURI [3 in 1] Defender Designed for iPhone 13 Pro Case 6.1 Inch, with 2 Pack Tempered Glass Screen Protector + 2 Pack Camera",
            "rating": 4.5,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          },
          {
            "pos": 38,
            "url": "/Cordking-iPhone-11-Anti-Scratch-Microfiber/dp/B09NGMBLNL/ref=zg_bs_2407760011_38/140-4851587-8700940?pd_rd_i=B09QNKR7GM&psc=1",
            "asin": "B09NGMBLNL",
            "price": 0,
            "title": "Cordking iPhone 11 Case, Silicone [Square Edges] & [Camera Protecion] Upgraded Phone Case with Soft Anti-Scratch Microfiber L",
            "rating": 4.8,
            "currency": "USD",
            "is_prime": false,
            "price_str": "",
            "price_upper": 0,
            "ratings_count": 0
          }
        ],
        "parse_status_code": 12000
      },
      "created_at": "2022-05-10 11:25:45",
      "updated_at": "2022-05-10 11:26:34",
      "page": 1,
      "url": "https://www.amazon.com/Best-Sellers/zgbs/x/2407760011/?pg=1",
      "job_id": "6929753341157204993",
      "status_code": 200,
      "parser_type": ""
    }
  ]

Data dictionary

HTML example

JSON structure

The amazon_bestsellers provides comprehensive data on the best-selling products on Amazon. The table below presents a detailed list of each field we parse, along with its description and data type. The table also includes some metadata.

Key

Description

Type

url

The URL of the Amazon Best Sellers page.

string

page

The current page number.

integer

pages

The total number of pages.

integer

query

The original search term.

string

results

A dictionary containing the results of the search.

object

results.pos

An indicator denoting the position of a bestselling item.

integer

results.url

The URL of the best selling item.

string

results.asin

Amazon Standard Identification Number.

string

results.price

The price of the product.

string

results.title

The title of the product.

string

results.rating

The rating of the product.

float

results.currency

The currency in which the price is denominated.

string

results.is_prime

Indicates whether the product is eligible for Amazon Prime.

boolean

results.price_str

The original price before any discounts or promotions

float

results.price_upper

The upper limit of the price if applicable.

float

results_ratings_count

The total number of ratings given to the product.

integer

parse_status_code

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

integer

created_at

The timestamp when the scraping job was created.

timestamp

updated_at

The timestamp when the scraping job was finished.

timestamp

job_id

The ID of the job associated with the scraping job.

string

status_code

The status code of the scraping job. You can see the scraper status codes described here.

integer

parser_type

The type of parser used for parsing the data.

string

PreviousSellers NextReviews

Last updated 10 months ago

Was this helpful?

Good afternoon

Request samples

Request parameter values

Generic

Localization

Pagination

Other

Code example

Structured data

Data dictionary

HTML example

JSON structure