Amazon Search API

Amazon Search API uses /api/v1/search?engine=amazon_search API endpoint to scrape real-time results.

The Amazon Search API lets developers tap into Amazon's huge product database. You can search for items, get sorted results based on relevance or reviews, and pull product details. It's like using Amazon's search, but for your own app or website.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    The parameter specifies your search query. It accepts any term or phrase you'd typically input in an Amazon search.

Localization

Filters

  • Name
    rh
    Required
    Optional
    Description

    This parameter filters search results based on specific criteria such as brand and ratings. You can find rh values either by calling the Amazon Search API or directly from an Amazon URL.
    For example, to filter items rated 4 stars and above and within a specific price range, separate the values with a comma , and use the parameter like this: rh=p_72:2661618011,p_36:2661612011. Here’s how it might look in a URL: https://www.amazon.com/s?k=electronics&rh=p_72:2661618011,p_36:2661612011.

  • Name
    sort_by
    Required
    Optional
    Description

    Parameter allows sorting search results by different criteria. Below is the list of available sorting options:

    • featured - default sort order.
    • price_low_to_high
    • price_high_to_low
    • average_review - sort by average customer reviews score.
    • newest_arrivals
    • bestsellers

  • Name
    price_min
    Required
    Optional
    Description

    This parameter controls the minimum price of the products returned. For instance - 10 value would return products with a minimum price of 10.

  • Name
    price_max
    Required
    Optional
    Description

    This parameter controls the maximum price of the products returned. For instance - 20.5 value would return products with a maximum price of 20.5.

Pagination

  • Name
    page
    Required
    Optional
    Description

    The parameter determines the results page number. It defaults to 1.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to amazon_search.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

API Examples

Full Response

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=amazon_search&q=Macbook+Pro
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "amazon_search",
  "q": "Macbook Pro"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_Rz4KNQmOp60YHNKOoyWl8DBv",
    "status": "Success",
    "created_at": "2024-04-30T12:56:47Z",
    "request_time_taken": 2.14,
    "parsing_time_taken": 0.17,
    "total_time_taken": 2.31,
    "request_url": "https://www.amazon.com/s?k=Macbook+Pro",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_Rz4KNQmOp60YHNKOoyWl8DBv.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_Rz4KNQmOp60YHNKOoyWl8DBv"
  },
  "search_parameters": {
    "engine": "amazon_search",
    "q": "Macbook Pro",
    "amazon_domain": "amazon.com"
  },
  "filters": [
    {
      "type": "Condition",
      "options": [
        {
          "text": "New",
          "rh": "n:172282,p_n_condition-type:2224371011"
        },
        ...
      ]
    },
    ...
  ],
  "organic_results": [
    {
      "position": 1,
      "asin": "B0CM5JV26D",
      "title": "2023 MacBook Pro Laptop M3 Pro chip with 11‑core CPU, 14‑core GPU: 14.2-inch Liquid Retina XDR Display, 18GB Unified Memory, 512GB SSD Storage. Works with iPhone/iPad; Space Black",
      "link": "https://www.amazon.com/Apple-MacBook-Laptop-11%E2%80%91core-14%E2%80%91core/dp/B0CM5JV26D/ref=sr_1_1?dib=eyJ2IjoiMSJ9.71LAQ6bN2QMwaNUxgmsmCDCVXxWLb_Tx8n1jjWvwdalCWn9Tlqj_MZYIDKi--Mwo5uzup5B8Roxia2PlygvhT5gKD6KUt8oIJkDu1R1nM64Qu15Xm071uRwulOy0S4Q4faTEt-OU4-WHjH4qIB9rSnv9zqRaRKrVyYQuiondNtMSCua3BTcuHy46z0AjUDSrn_Nfy9tLIM0XsXPyhDP4IGK-aVDfXY6Yh7zyp4TkReY.kuOcFmkwoRGw2FuKOrUFzS0CSLJONttLW_Exi38WGEA&dib_tag=se&keywords=Macbook+Pro&qid=1714481809&sr=8-1",
      "brand": "Apple",
      "rating": 4.7,
      "reviews": 229,
      "recent_sales": "1K+ bought in past month",
      "price": "$1,799.00",
      "extracted_price": 1799,
      "original_price": "$1,999.00",
      "extracted_original_price": 1999,
      "fulfillment": {
        "standard_delivery": {
          "text": "FREE delivery Mon, May 6",
          "type": "FREE delivery",
          "date": "Mon, May 6"
        },
        "fastest_delivery": {
          "text": "Or fastest delivery Tomorrow, May 1",
          "type": "Or fastest delivery",
          "date": "Tomorrow, May 1"
        }
      },
      "more_offers": {
        "lowest_price": "$1,781.01",
        "extracted_lowest_price": 1781.01,
        "link": "https://www.amazon.com/gp/offer-listing/B0CM5JV26D/ref=sr_1_1_olp?keywords=Macbook+Pro&dib_tag=se&dib=eyJ2IjoiMSJ9.71LAQ6bN2QMwaNUxgmsmCDCVXxWLb_Tx8n1jjWvwdalCWn9Tlqj_MZYIDKi--Mwo5uzup5B8Roxia2PlygvhT5gKD6KUt8oIJkDu1R1nM64Qu15Xm071uRwulOy0S4Q4faTEt-OU4-WHjH4qIB9rSnv9zqRaRKrVyYQuiondNtMSCua3BTcuHy46z0AjUDSrn_Nfy9tLIM0XsXPyhDP4IGK-aVDfXY6Yh7zyp4TkReY.kuOcFmkwoRGw2FuKOrUFzS0CSLJONttLW_Exi38WGEA&qid=1714481809&sr=8-1",
        "offers_count": 6,
        "description": "(6 used & new offers)"
      },
      "attributes": [
        {
          "name": "Display Size",
          "value": "14.2 inches"
        },
        ...
      ],
      "is_prime": true,
      "is_overall_pick": true,
      "thumbnail": "https://m.media-amazon.com/images/I/61RJn0ofUsL._AC_UY218_.jpg"
    },
    ...
  ],
  "pagination": {
    "current": 1,
    "next": "https://www.amazon.com/s?k=Macbook+Pro&page=2&qid=1714481809&ref=sr_pg_1",
    "other_pages": {
      "2": "https://www.amazon.com/s?k=Macbook+Pro&page=2&qid=1714481809&ref=sr_pg_2",
      ...
    }
  }
}

Organic Results - Consumables

Organic Results - Consumables
GET
https://www.searchapi.io/api/v1/search?engine=amazon_search&q=Bottled+water
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "amazon_search",
  "q": "Bottled water"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "organic_results": [
    {
      "position": 1,
      "asin": "B00091S3K4",
      "title": "Pure Life, Purified Water, 8 Fl Oz, Plastic Bottled Water, 24 Pack",
      "link": "https://www.amazon.com/Nestle-Pure-Life-Water-pack/dp/B00091S3K4/ref=sr_1_1?dib=eyJ2IjoiMSJ9.KOD0kHYpXZDpp5rEFi_4GQxD4qtzST9nY-Pe4T770Ro4DwpC-NdLDmEjAaDdmNYurELCPGt7o175Sq-UFjO5EdlTsnD5Ls7vhtl7C7KZkAVQ0yi973df7UGwIcXTPTHZjHXZGcpgr3C-EBkRhHtH-mVJOjM7uZTX3ty9UhVrLzkAzazxf-C29ha2llapPgZE9rwmjYSVCjZMep8pbJvxhwGmz9jBGkqq-2zcY0YcJ9E8xK07hLhJKDRj6QqS21UuuMnruER5KWdo46iIZwIJfYtUVWeVPX4lmjMaytaYpcw.r_1Z7bct-M2B_9FJk8Ti5mzmiF2UEhCONuJ9y5-mhFw&dib_tag=se&keywords=Bottled+water&qid=1714482294&sr=8-1",
      "tags": ["purified", "8 Fl Oz (Pack of 24)"],
      "rating": 4.8,
      "reviews": 39153,
      "recent_sales": "30K+ bought in past month",
      "media": "SNAP EBT eligible",
      "price": "$4.00",
      "extracted_price": 4,
      "original_price": "$4.99",
      "extracted_original_price": 4.99,
      "price_per": {
        "price": 0.02,
        "unit": "Fl Oz"
      },
      "fulfillment": {
        "standard_delivery": {
          "text": "FREE delivery on $35 shipped by Amazon.",
          "type": "FREE delivery on $35 shipped by Amazon.",
          "condition": "FREE delivery on $35 shipped by Amazon."
        }
      },
      "more_offers": {
        "lowest_price": "$1.11",
        "extracted_lowest_price": 1.11,
        "link": "https://www.amazon.com/gp/offer-listing/B00091S3K4/ref=sr_1_1_olp?keywords=Bottled+water&dib_tag=se&dib=eyJ2IjoiMSJ9.KOD0kHYpXZDpp5rEFi_4GQxD4qtzST9nY-Pe4T770Ro4DwpC-NdLDmEjAaDdmNYurELCPGt7o175Sq-UFjO5EdlTsnD5Ls7vhtl7C7KZkAVQ0yi973df7UGwIcXTPTHZjHXZGcpgr3C-EBkRhHtH-mVJOjM7uZTX3ty9UhVrLzkAzazxf-C29ha2llapPgZE9rwmjYSVCjZMep8pbJvxhwGmz9jBGkqq-2zcY0YcJ9E8xK07hLhJKDRj6QqS21UuuMnruER5KWdo46iIZwIJfYtUVWeVPX4lmjMaytaYpcw.r_1Z7bct-M2B_9FJk8Ti5mzmiF2UEhCONuJ9y5-mhFw&qid=1714482294&sr=8-1",
        "offers_count": 7,
        "description": "(7 new offers)"
      },
      "thumbnail": "https://m.media-amazon.com/images/I/71JRmfguA4L._AC_UL320_.jpg"
    },
    ...
  ],
}

Organic Results - Videos

Organic Results - Videos
GET
https://www.searchapi.io/api/v1/search?engine=amazon_search&q=Videos
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "amazon_search",
  "q": "Videos"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "organic_results": [
    {
      "position": 1,
      "asin": "B0CX7K6FZD",
      "title": "Fallout - Season 1",
      "link": "https://www.amazon.com/The-Trap/dp/B0CN4H1V9D/ref=sr_1_1?dib=eyJ2IjoiMSJ9.tYYQaF4yrHB9LmYvSQKt1H_6_9TUf-Ri5uF-6P8lr6DW27wPrHE7qe-tQGVEfgC-0p0fsPeIatOp8VpFnDW-4UW3juKB3Vx6eNqWT5zrQmuv3lnHbhPKfLdoE3BxwfAwEKFKnPS0zisvFZYI6IpjxtY53TFIocWbiVJFnsdH0veIAnuQ5zF_QhFINIUVdrn13SFZetdTLntslTqjjSkrtfKAJpcI9Lxi9dG7YEAUIp4.GDEDU90tBcD-7gzVnbgBZ0dn3sud3DUOZimc1ExxGd0&dib_tag=se&keywords=Videos&qid=1714482488&sr=8-1",
      "credits": {
        "starring": [
          {
            "name": "Walton Goggins",
            "link": "https://www.amazon.com/s?ie=UTF8&search-alias=&field-keywords=Walton+Goggins"
          },
          ...
        ],
        "directed_by": [
          {
            "name": "Jonathan Nolan",
            "link": "https://www.amazon.com/s?ie=UTF8&search-alias=&field-keywords=Jonathan+Nolan"
          }
        ]
      },
      "rating": 4.6,
      "reviews": 2765,
      "media": "Prime Video",
      "is_prime_video": true,
      "thumbnail": "https://m.media-amazon.com/images/I/81vRr4A0eeL._AC_UY218_.jpg"
    },
    ...
  ]
}

Organic Results - Books

Organic Results - Books
GET
https://www.searchapi.io/api/v1/search?engine=amazon_search&q=Harry+Potter
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "amazon_search",
  "q": "Harry Potter"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "organic_results": [
    ...
    {
      "position": 4,
      "asin": "0545162076",
      "title": "Harry Potter Paperback Box Set (Books 1-7)",
      "link": "https://www.amazon.com/Harry-Potter-Paperback-Box-Books/dp/0545162076/ref=sr_1_4?dib=eyJ2IjoiMSJ9.SyFm1P3-FgOopf2dPEKAz0UypT92E9prKRfredEZiDL_uRFlJv0IZuYXqo_6Bvqsku-1HmffWgZQMNpGlFgdR3YHecDdFg4LSk8FOQwnx4L4gddXFe4NyuxBbyOKdtNNyVwH78lFjvyLDJneOhG3NlGqd7NzJliTmLG6aL27yLd4kP1vMUlDdpCW6dEUt0BkOC1KVFVnz2N0fAy9nNX2LVbyIOLPgKjteTWb-xvUnQ0.8VwTHmcCjTK-iG36-xTmdvOasg43KUG0qK63ETGia8U&dib_tag=se&keywords=Harry+Potter&qid=1714482578&sr=8-4",
      "authors": [
        {
          "name": "J. K. Rowling",
          "link": "https://www.amazon.com/J-K-Rowling/e/B000AP9A6K?ref=sr_ntt_srch_lnk_4&qid=1714482578&sr=8-4"
        }
      ],
      "rating": 4.9,
      "reviews": 73184,
      "media": "Paperback",
      "price": "$45.44",
      "extracted_price": 45.44,
      "original_price": "$100.00",
      "extracted_original_price": 100,
      "prices": [
        {
          "name": "Hardcover",
          "price": "$149.74",
          "extracted_price": 149.74,
          "original_price": "$226.93",
          "extracted_original_price": 226.93,
          "fulfillment": {
            "standard_delivery": {
              "text": "FREE delivery Mon, May 6",
              "type": "FREE delivery",
              "date": "Mon, May 6"
            },
            "fastest_delivery": {
              "text": "Or fastest delivery Tomorrow, May 1",
              "type": "Or fastest delivery",
              "date": "Tomorrow, May 1"
            }
          },
          "more_offers": {
            "lowest_price": "$79.00",
            "extracted_lowest_price": 79,
            "link": "https://www.amazon.com/gp/offer-listing/1338864297/ref=sr_1_4_olp?keywords=Harry+Potter&dib_tag=se&dib=eyJ2IjoiMSJ9.SyFm1P3-FgOopf2dPEKAz0UypT92E9prKRfredEZiDL_uRFlJv0IZuYXqo_6Bvqsku-1HmffWgZQMNpGlFgdR3YHecDdFg4LSk8FOQwnx4L4gddXFe4NyuxBbyOKdtNNyVwH78lFjvyLDJneOhG3NlGqd7NzJliTmLG6aL27yLd4kP1vMUlDdpCW6dEUt0BkOC1KVFVnz2N0fAy9nNX2LVbyIOLPgKjteTWb-xvUnQ0.8VwTHmcCjTK-iG36-xTmdvOasg43KUG0qK63ETGia8U&qid=1714482578&sr=8-4",
            "offers_count": 40,
            "description": "(40 used & new offers)"
          }
        },
        ...
      ],
      "fulfillment": {
        "standard_delivery": {
          "text": "FREE delivery Mon, May 6",
          "type": "FREE delivery",
          "date": "Mon, May 6"
        },
        "fastest_delivery": {
          "text": "Or fastest delivery Tomorrow, May 1",
          "type": "Or fastest delivery",
          "date": "Tomorrow, May 1"
        }
      },
      "more_offers": {
        "lowest_price": "$33.90",
        "extracted_lowest_price": 33.9,
        "link": "https://www.amazon.com/gp/offer-listing/0545162076/ref=sr_1_4_olp?keywords=Harry+Potter&dib_tag=se&dib=eyJ2IjoiMSJ9.SyFm1P3-FgOopf2dPEKAz0UypT92E9prKRfredEZiDL_uRFlJv0IZuYXqo_6Bvqsku-1HmffWgZQMNpGlFgdR3YHecDdFg4LSk8FOQwnx4L4gddXFe4NyuxBbyOKdtNNyVwH78lFjvyLDJneOhG3NlGqd7NzJliTmLG6aL27yLd4kP1vMUlDdpCW6dEUt0BkOC1KVFVnz2N0fAy9nNX2LVbyIOLPgKjteTWb-xvUnQ0.8VwTHmcCjTK-iG36-xTmdvOasg43KUG0qK63ETGia8U&qid=1714482578&sr=8-4",
        "offers_count": 89,
        "description": "(89 used & new offers)"
      },
      "other_formats": [
        {
          "asin": "0739352245",
          "title": "Audio CD",
          "link": "https://www.amazon.com/Harry-Potter-1-Audio-Collection/dp/0739352245/ref=sr_1_4?dib=eyJ2IjoiMSJ9.SyFm1P3-FgOopf2dPEKAz0UypT92E9prKRfredEZiDL_uRFlJv0IZuYXqo_6Bvqsku-1HmffWgZQMNpGlFgdR3YHecDdFg4LSk8FOQwnx4L4gddXFe4NyuxBbyOKdtNNyVwH78lFjvyLDJneOhG3NlGqd7NzJliTmLG6aL27yLd4kP1vMUlDdpCW6dEUt0BkOC1KVFVnz2N0fAy9nNX2LVbyIOLPgKjteTWb-xvUnQ0.8VwTHmcCjTK-iG36-xTmdvOasg43KUG0qK63ETGia8U&dib_tag=se&keywords=Harry+Potter&qid=1714482578&sr=8-4"
        }
      ],
      "is_prime": true,
      "thumbnail": "https://m.media-amazon.com/images/I/81GJMtnxqDL._AC_UY218_.jpg"
    },
    ...
  ]
}