Amazon Deals API Documentation
The Amazon Deals API returns the deals listed on Amazon's Today's Deals page. Each deal comes with its deal price, reference price, discount, deal type, claimed percentage and start and end times, and the list can be filtered by department, brand, price, discount, lightning deals and Prime programs.
API Parameters
Filters
-
- Name
-
deal_type - Required
- Optional
- Description
-
Parameter defines the type of deals to list. Available values:
all- default. Every deal on Today's Deals.lightning_deal- Only lightning deals, which run for a few hours and reportpercent_claimed.
-
- Name
-
category_id - Required
- Optional
- Description
-
A deals department ID that limits the list to one department (e.g.
493964for Electronics onamazon.com). Take it from thefiltersof a response, or from the Amazon Categories API withcategory_type=deals.
-
- Name
-
brand_id - Required
- Optional
- Description
-
One or more comma-separated brand IDs (e.g.
200611). Take them from a deal'sbrand_idor from thefiltersof a response.
-
- Name
-
price_min - Required
- Optional
- Description
-
This parameter controls the minimum deal price. For instance -
10value would return deals priced at10or more. The price is in the marketplace's own currency (e.g.EURonamazon.de).
-
- Name
-
price_max - Required
- Optional
- Description
-
This parameter controls the maximum deal price. For instance -
25value would return deals priced at25or less. The price is in the marketplace's own currency (e.g.EURonamazon.de).
-
- Name
-
discount_min - Required
- Optional
- Description
-
This parameter controls the minimum discount percentage, from
0to100. For instance -50value would return deals at least 50% off.
-
- Name
-
discount_max - Required
- Optional
- Description
-
This parameter controls the maximum discount percentage, from
0to100.
-
- Name
-
prime_exclusive - Required
- Optional
- Description
-
Set to
trueto list only deals exclusive to Prime members.
-
- Name
-
prime_early_access - Required
- Optional
- Description
-
Set to
trueto list only deals that Prime members can access early.
Localization
-
- Name
-
amazon_domain - Required
- Optional
- Description
-
The default parameter
amazon.comdefines the Amazon domain of the search. Check the full list of supported Amazon domains.
-
- Name
-
language - Required
- Optional
- Description
-
The
languageparameter is used to specify the display language of Amazon page. Check the full list of supported Amazon display languages.
Delivery
-
- Name
-
postal_code - Required
- Optional
- Description
-
Postal code for the delivery location. Use this for postal-code countries (e.g.
10001for US,SW1A 0AAfor UK,M5V 2T6for CA). Check the list of supported Amazon postal codes by domain and format. The response reports the outcome insearch_metadata.delivery_location:applied,not_applied, orunverified.
-
- Name
-
delivery_city - Required
- Optional
- Description
-
City for the delivery address in snake_case (e.g.
delivery_city=riyadh). Only supported for city-based countries (Saudi Arabia, UAE, Egypt). For other countries usepostal_code. See the full list of supported Amazon delivery cities and areas by domain.
-
- Name
-
delivery_area - Required
- Optional
- Description
-
Area within the city, only available for
amazon.ae(e.g.business_bay). Optional and must be sent withdelivery_city. See the full list of supported Amazon delivery areas
-
- Name
-
delivery_country - Required
- Optional
- Description
-
A two-letter ISO 3166-1 alpha-2 country code that defines the country of the delivery address.
By default, it is set to the country code of the selected Amazon domain (e.g.deforamazon.de), you can also explicitly set it to a different country. Check the full list of supported Amazon delivery countries.
Pagination
-
- Name
-
page - Required
- Optional
- Description
-
The parameter determines the results page number. Each page has up to 30 deals. Amazon lists at most 500 deals per filter combination, so the last page is
17; narrow the list withcategory_idorbrand_idto reach more deals.
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_deals.
API key
-
- Name
-
api_key - Required
- Required
- Description
-
The
api_keyauthenticates 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).
Zero Data Retention
-
- Name
-
zero_retention - Enterprise Only
- Enterprise Only
- Required
- Optional
- Description
-
Set this parameter to
trueto disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.
API Examples
Full Response
https://www.searchapi.io/api/v1/search?engine=amazon_deals
- 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_deals"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_zTJtF4KgwpfQYTuA3ZdJuGOm",
"status": "Success",
"created_at": "2026-11-16T19:28:17Z",
"request_time_taken": 3.54,
"parsing_time_taken": 0.16,
"total_time_taken": 3.7,
"request_url": "https://www.amazon.com/deals",
"html_url": "https://www.searchapi.io/api/v1/searches/search_yHVsn2dk3UNy3vTXYlyHlm5C.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_rCg7URntege8HSgYapZevSrC"
},
"search_parameters": {
"engine": "amazon_deals",
"amazon_domain": "amazon.com",
"delivery_country": "us"
},
"deals": [
{
"position": 1,
"asin": "B0HJB6P7QM",
"title": "Apple Watch Series 12 GPS + Cellular 42mm Smartwatch | Radiant Gold Titanium Case, Burgundy Sport Band - S/M. Health + Fitness + Sleep Tracking, Heart Rate, Safety",
"link": "https://www.amazon.com/Apple-Cellular-Smartwatch-Titanium-Burgundy/dp/B0HJB6P7QM",
"thumbnail": "https://m.media-amazon.com/images/I/71qH69EF0HL.jpg",
"rating": 4.7,
"reviews": 95,
"price": "$629.00",
"extracted_price": 629.0,
"original_price": "$699.00",
"extracted_original_price": 699.0,
"original_price_label": "List",
"discount_percentage": 10,
"deal_id": "ffbd8924",
"deal_type": "best_deal",
"deal_badge": "Early Black Friday Deal",
"starts_at": "2026-11-15T08:00:00.000Z",
"ends_at": "2026-12-01T07:59:59.000Z",
"brand_id": "110955",
"category_ids": [
"172282",
"493964"
]
},
"..."
],
"filters": [
{
"type": "Department",
"options": [
{
"text": "Amazon Devices & Accessories",
"value": "16333373011"
},
"..."
]
},
"..."
],
"pagination": {
"current": 1,
"next": 2
}
}
Lightning Deals
https://www.searchapi.io/api/v1/search?deal_type=lightning_deal&engine=amazon_deals
- 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_deals",
"deal_type": "lightning_deal"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_JBhpzFSjDLeb5pisZEVe48At",
"status": "Success",
"created_at": "2026-11-16T19:28:21Z",
"request_time_taken": 3.76,
"parsing_time_taken": 0.08,
"total_time_taken": 3.83,
"request_url": "https://www.amazon.com/deals",
"html_url": "https://www.searchapi.io/api/v1/searches/search_o0JngbQ3dhFtSX8ZU6DYFnmh.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_OgBCzZnFI3mP0ZieusdGC4gh"
},
"search_parameters": {
"engine": "amazon_deals",
"amazon_domain": "amazon.com",
"deal_type": "lightning_deal",
"delivery_country": "us"
},
"deals": [
{
"position": 1,
"asin": "B0DYD8VT9C",
"title": "Renogy Solar Panels 200 Watt N-Type, 16BB 25% High-Efficiency | 200W Solar Panel for RV, Upgraded Smaller & Lighter Design, Save Space on Class B Van, Marine, Boat, Trailer, Roof, IP67",
"link": "https://www.amazon.com/Renogy-Solar-Watt-N-Type-Panel/dp/B0DYD8VT9C",
"thumbnail": "https://m.media-amazon.com/images/I/71+0UBdtHGL.jpg",
"rating": 4.6,
"reviews": 1381,
"price": "$169.99",
"extracted_price": 169.99,
"original_price": "$199.99",
"extracted_original_price": 199.99,
"original_price_label": "List",
"discount_percentage": 15,
"deal_id": "6cecafff",
"deal_type": "lightning_deal",
"percent_claimed": 3.0,
"starts_at": "2026-11-16T14:35:00.000Z",
"ends_at": "2026-11-17T02:35:00.000Z",
"brand_id": "191449",
"category_ids": [
"2972638011",
"3238155011"
]
},
"..."
]
}
Filter by Department and Discount
https://www.searchapi.io/api/v1/search?category_id=493964&discount_min=50&engine=amazon_deals
- 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_deals",
"category_id": "493964",
"discount_min": "50"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_9EiffK2Wz7XOwZElI8xxzwzS",
"status": "Success",
"created_at": "2026-11-16T19:28:25Z",
"request_time_taken": 4.76,
"parsing_time_taken": 0.03,
"total_time_taken": 4.79,
"request_url": "https://www.amazon.com/deals",
"html_url": "https://www.searchapi.io/api/v1/searches/search_8pagH5NGyCpylQPdsDuLzmSe.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_Y3Seo0vwB8RR6MkLXhe8JqP3"
},
"search_parameters": {
"engine": "amazon_deals",
"amazon_domain": "amazon.com",
"category_id": "493964",
"discount_min": 50,
"delivery_country": "us"
},
"deals": [
{
"position": 1,
"asin": "B0G2D1R15Q",
"title": "Ring Battery Doorbell 2K (newest model), Matte Mocha",
"link": "https://www.amazon.com/Ring-Battery-Doorbell-newest-Built/dp/B0G2D1R15Q",
"thumbnail": "https://m.media-amazon.com/images/I/51kY6VkfPeL.jpg",
"rating": 4.3,
"reviews": 9085,
"price": "$39.99",
"extracted_price": 39.99,
"original_price": "$99.99",
"extracted_original_price": 99.99,
"original_price_label": "Typical",
"discount_percentage": 60,
"deal_id": "d0d0a6d6",
"deal_type": "best_deal",
"deal_badge": "Early Black Friday Deal",
"starts_at": "2026-11-09T05:00:00.000Z",
"ends_at": "2026-12-01T07:59:59.000Z",
"brand_id": "200611",
"category_ids": [
"16333372011",
"172282",
"493964",
"228013",
"16333373011",
"468240",
"502394"
]
},
"..."
],
"filters": [
{
"type": "Department",
"options": [
{
"text": "Electronics",
"value": "493964",
"is_selected": true
},
"..."
]
},
"..."
]
}