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

We use Realtime integration method in our examples. If you would like to use some other integration method in your request (e.g. Push-Pull or Proxy Endpoint), refer to the integration methods section.

Request parameter values

Generic

Basic setup and customization options for scraping Amazon search results.

- mandatory parameter

Localization

Adapt results to specific geographical locations, domains, and languages.

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.

Other

Additional advanced settings and controls for specialized requirements.

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