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
-
- Name
-
amazon_domain
- Required
- Optional
- Description
-
The default parameter
amazon.com
defines the Amazon domain of the search. Check the full list of supported Amazon domains.
-
- Name
-
language
- Required
- Optional
- Description
-
The
language
parameter is used to specify the display language of Amazon page. Check the full list of supported Amazon display languages.
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 of10
.
-
- 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 of20.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
https://www.searchapi.io/api/v1/search?engine=amazon_search&q=Macbook+Pro
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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"
},
{
"text": "Renewed",
"rh": "n:172282,p_n_condition-type:16907720011"
},
{
"text": "Used",
"rh": "n:172282,p_n_condition-type:2224373011"
}
]
},
...
],
"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",
"3": "https://www.amazon.com/s?k=Macbook+Pro&page=3&qid=1714481809&ref=sr_pg_3"
}
}
}
Organic Results - Consumables
https://www.searchapi.io/api/v1/search?engine=amazon_search&q=Bottled+water
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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
https://www.searchapi.io/api/v1/search?engine=amazon_search&q=Videos
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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"
},
{
"name": "Ella Purnell",
"link": "https://www.amazon.com/s?ie=UTF8&search-alias=&field-keywords=Ella+Purnell"
},
{
"name": "Aaron Moten",
"link": "https://www.amazon.com/s?ie=UTF8&search-alias=&field-keywords=Aaron+Moten"
}
],
"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
https://www.searchapi.io/api/v1/search?engine=amazon_search&q=Harry+Potter
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
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)
{
"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"
},
...
]
}