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

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, and 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

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,