Search

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

Explore data dictionary for each Amazon Search feature, offering a brief description, screenshot, parsed JSON code snippet, and a table defining each parsed field. Navigate through the details using the right-side navigation or scrolling down the page.

Query parameters

ParameterDescriptionDefault Value

source

Data source. More info.

amazon_search

domain

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

com

query

UTF-encoded keyword

-

start_page

Starting page number

1

pages

Number of pages to retrieve

1

geo_location

The Deliver to location. See our guide to using this parameter here.

-

user_agent_type

Device type and browser. The full list can be found here.

desktop

render

Enables JavaScript rendering. More info.

-

callback_url

URL to your callback endpoint. More info.

-

parse

true will return structured data.

-

context: category_id

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

-

context: merchant_id

Search for items sold by a particular seller.

-

- required parameter

Code examples

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

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

The example above uses the Realtime integration method. If you would like to use some other integration method in your query (e.g. Push-Pull or Proxy Endpoint), refer to the integration methods section.

Sample output

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

Data dictionary

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

HTML example

JSON structure

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

KeyDescriptionType

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.

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"
    },
    ...
]
KeyDescriptionType

url

The URL of the product.

string

asin

Amazon Standard Identification Number.

string