Amazon Deals API Documentation

GET   /api/v1/search?engine=amazon_deals

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 report percent_claimed.

  • Name
    category_id
    Required
    Optional
    Description

    A deals department ID that limits the list to one department (e.g. 493964 for Electronics on amazon.com). Take it from the filters of a response, or from the Amazon Categories API with category_type=deals.

  • Name
    brand_id
    Required
    Optional
    Description

    One or more comma-separated brand IDs (e.g. 200611). Take them from a deal's brand_id or from the filters of a response.

  • Name
    price_min
    Required
    Optional
    Description

    This parameter controls the minimum deal price. For instance - 10 value would return deals priced at 10 or more. The price is in the marketplace's own currency (e.g. EUR on amazon.de).

  • Name
    price_max
    Required
    Optional
    Description

    This parameter controls the maximum deal price. For instance - 25 value would return deals priced at 25 or less. The price is in the marketplace's own currency (e.g. EUR on amazon.de).

  • Name
    discount_min
    Required
    Optional
    Description

    This parameter controls the minimum discount percentage, from 0 to 100. For instance - 50 value would return deals at least 50% off.

  • Name
    discount_max
    Required
    Optional
    Description

    This parameter controls the maximum discount percentage, from 0 to 100.

  • Name
    prime_exclusive
    Required
    Optional
    Description

    Set to true to list only deals exclusive to Prime members.

  • Name
    prime_early_access
    Required
    Optional
    Description

    Set to true to list only deals that Prime members can access early.

Localization

Delivery

  • Name
    postal_code
    Required
    Optional
    Description

    Postal code for the delivery location. Use this for postal-code countries (e.g. 10001 for US, SW1A 0AA for UK, M5V 2T6 for CA). Check the list of supported Amazon postal codes by domain and format. The response reports the outcome in search_metadata.delivery_location: applied, not_applied, or unverified.

  • 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 use postal_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 with delivery_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. de for amazon.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 with category_id or brand_id to 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_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).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to 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

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=amazon_deals
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "amazon_deals"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "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

Lightning Deals
GET
https://www.searchapi.io/api/v1/search?deal_type=lightning_deal&engine=amazon_deals
Request
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)
Response
{
  "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

Filter by Department and Discount
GET
https://www.searchapi.io/api/v1/search?category_id=493964&discount_min=50&engine=amazon_deals
Request
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)
Response
{
  "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
        },
        "..."
      ]
    },
    "..."
  ]
}