> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keyapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Deals

> Retrieve active Amazon deals with rich filtering options. Filter by category, star rating, price range, discount percentage, and deal type (Lightning Deals, Prime Exclusive, Prime Early Access).

<div className="inline-flex items-center gap-2 px-4 py-2 bg-yellow-50 dark:bg-yellow-900/20 border border-yellow-200 dark:border-yellow-800 rounded-lg">
  <span className="text-base">🪙</span>
  <span className="text-sm font-medium text-yellow-900 dark:text-yellow-100"><span className="font-semibold">3 credits</span><span className="text-yellow-700 dark:text-yellow-300 ml-1">per request</span></span>
</div>

## Copy for AI

<div className="my-6 rounded-xl border border-gray-200 bg-gray-50 p-5 dark:border-gray-800 dark:bg-gray-900/40">
  <div className="min-w-0">
    <p className="text-base font-semibold text-gray-900 dark:text-gray-100">🤖 Why Code When AI Can Do It For You?</p>
    <p className="mt-1 text-sm text-gray-700 dark:text-gray-300">Stop writing code like it's 1970! Let AI do the heavy lifting - click the sparkles to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.</p>
  </div>

  <div className="mt-4">
    <button
      type="button"
      className="inline-flex items-center gap-2 rounded-md border border-emerald-300 bg-emerald-50 px-3 py-2 text-sm font-medium text-emerald-800 hover:bg-emerald-100 dark:border-emerald-700 dark:bg-emerald-900/30 dark:text-emerald-100 dark:hover:bg-emerald-900/50"
      onClick={() => navigator.clipboard.writeText(`I want to make an API call to https://api.keyapi.ai/v1/amazon/deals.

Please help me write code to make this API call and handle the response appropriately. Include error handling and best practices.

Here are the details:

Endpoint: GET https://api.keyapi.ai/v1/amazon/deals

Description: Deals

Required Headers:
--header 'Authorization: Bearer <YOUR_API_KEY>'

Parameters:
- country (Optional): Sets the Amazon domain, marketplace country, language and currency.
Allowed values: US, AU, BR, CA, CN, FR, DE, IN, IT, MX, NL, SG, ES, TR, AE, GB, JP, SA, PL, SE, BE, EG, ZA, IE. Example: us
- offset (Optional): Number of results to skip / index to start from (for pagination). Works with multiples of 30 (like on Amazon's deals page) - 0, 30, 60, 90, etc.. Example: 0
- categories (Optional): Return deals with products in specific categories / departments. Multiple categories can be specified as a comma (,) separated list. Numeric category id's can be found in the URL after selecting a specific category on https://www.amazon.com/deals.
Examples:
502394
2619525011,2617941011
- min_product_star_rating (Optional): Return deals with products star rating greater than a specific value
Allowed values: ALL, 1, 2, 3, 4. Example: ALL
- price_range (Optional): Return deals with price within a specific price range. 1 is lowest price range shown on Amazon (e.g. Under $25) while 5 is the highest price range (e.g. $200 & Above).
Allowed values: ALL, 1, 2, 3, 4, 5. Example: ALL
- discount_range (Optional): Return deals with discount within a specific discount range. 1 is lowest discount range shown on Amazon (e.g. 10% off or more) while 5 is the highest discount range (e.g. 70% off or more).
Allowed values: ALL, 1, 2, 3, 4, 5. Example: ALL
- brands (Optional): Return deals with products by specific brands. Multiple brands can be specified separated by comma (,). In addition, brand names can be found under the Brand filter on the filter/refinements panel on https://www.amazon.com/deals (when applicable).

Examples:
AQUA CREST
Daixers,Antarctic Star
- prime_early_access (Optional): Only return prime early access deals.
- prime_exclusive (Optional): Only return prime exclusive deals.
- lightning_deals (Optional): Only return lightning deals
- language (Optional): The language of the results. In case not specified, results will be returned in the default domain language.
Supported languages per country:
US: en_US, es_US
AU: en_AU
BR: pt_BR
CA: en_CA, fr_CA
FR: fr_FR, en_GB
DE: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK
IN: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN
IT: it_IT, en_GB
MX: es_MX
NL: nl_NL, en_GB
SG: en_SG
ES: es_ES, pt_PT, en_GB
TR: tr_TR
AE: en_AE, ar_AE
GB: en_GB
JP: ja_JP, en_US, zh_CN
SA: ar_AE, en_AE
PL: pl_PL
SE: sv_SE, en_GB
BE: fr_BE, nl_BE, en_GB
EG: ar_AE, en_AE
ZA: en_ZA
IE: en_IE
- fields (Optional): A comma separated list of deal fields to include in the response (field projection). By default all fields are returned.

Example: deal_type,deal_title,deal_ends_at,savings_amount

Example Response:
{
"code": 0,
"message": "success",
"data": {
"deals": [
  {
    "deal_id": "a2c250a5",
    "deal_type": "BEST_DEAL",
    "deal_title": "Samsung Galaxy S26 Ultra, Unlocked Android Smartphone + $200 Gift Card, 512GB, Privacy Display, Galaxy AI, AI Camera, Super Fast Charging 3.0, Durable Battery, 2026, Cobalt Violet",
    "deal_photo": "https://m.media-amazon.com/images/I/61gvb-3EjrL.jpg",
    "deal_state": "AVAILABLE",
    "deal_url": "https://www.amazon.com/Samsung-Unlocked-Android-Smartphone-Charging/dp/B0GGT7CXF5",
    "canonical_deal_url": "https://www.amazon.com/deal/a2c250a5",
    "deal_starts_at": "2026-02-25T18:00:00.000Z",
    "deal_ends_at": "2026-03-11T06:59:59.000Z",
    "deal_price": {
      "amount": "1299.99",
      "currency": "USD"
    },
    "list_price": {
      "amount": "1699.99",
      "currency": "USD"
    },
    "savings_percentage": 24,
    "savings_amount": {
      "amount": "400.0",
      "currency": "USD"
    },
    "deal_badge": "24% off",
    "type": "SINGLE_ITEM",
    "product_asin": "B0GGT7CXF5"
  },
  {
    "deal_id": "8d63397f",
    "deal_type": "BEST_DEAL",
    "deal_title": "acer Aspire 16 AI Copilot+ PC | 16\" WUXGA 120Hz Multi-Touch Display | Snapdragon X X1-26-100 | NPU: 45 Tops - GPU: Up to 1.7 TFLOPs | 16GB LPDDR5X | 512GB PCIe Gen 4 SSD | Wi-Fi 7 | A16-11MT-X669",
    "deal_photo": "https://m.media-a
... (truncated)`)}
    >
      <span>✨</span>
      <span>Copy for AI</span>
    </button>
  </div>
</div>


## OpenAPI

````yaml en/amazon.openapi.json GET /v1/amazon/deals
openapi: 3.0.1
info:
  title: Amazon API english documentation
  description: >-
    The english reference documentation of the Amazon API includes the
    interface's purpose, parameter description, response status, and sample
    structure.
  version: 1.0.0
servers:
  - url: https://api.keyapi.ai
    description: Production
security: []
tags: []
paths:
  /v1/amazon/deals:
    get:
      tags: []
      summary: Deals
      description: >-
        Retrieve active Amazon deals with rich filtering options. Filter by
        category, star rating, price range, discount percentage, and deal type
        (Lightning Deals, Prime Exclusive, Prime Early Access).
      parameters:
        - name: country
          in: query
          description: >-
            Sets the Amazon domain, marketplace country, language and currency.

            Allowed values: US, AU, BR, CA, CN, FR, DE, IN, IT, MX, NL, SG, ES,
            TR, AE, GB, JP, SA, PL, SE, BE, EG, ZA, IE
          required: false
          example: us
          schema:
            type: string
            default: us
        - name: offset
          in: query
          description: >-
            Number of results to skip / index to start from (for pagination).
            Works with multiples of 30 (like on Amazon's deals page) - 0, 30,
            60, 90, etc.
          required: false
          example: 0
          schema:
            type: number
            default: 0
        - name: categories
          in: query
          description: >-
            Return deals with products in specific categories / departments.
            Multiple categories can be specified as a comma (,) separated list.
            Numeric category id's can be found in the URL after selecting a
            specific category on https://www.amazon.com/deals.

            Examples:
              502394
              2619525011,2617941011
          required: false
          schema:
            type: string
        - name: min_product_star_rating
          in: query
          description: |-
            Return deals with products star rating greater than a specific value
            Allowed values: ALL, 1, 2, 3, 4
          required: false
          example: ALL
          schema:
            type: string
            default: ALL
        - name: price_range
          in: query
          description: >-
            Return deals with price within a specific price range. 1 is lowest
            price range shown on Amazon (e.g. Under $25) while 5 is the highest
            price range (e.g. $200 & Above).

            Allowed values: ALL, 1, 2, 3, 4, 5
          required: false
          example: ALL
          schema:
            type: string
            default: ALL
        - name: discount_range
          in: query
          description: >-
            Return deals with discount within a specific discount range. 1 is
            lowest discount range shown on Amazon (e.g. 10% off or more) while 5
            is the highest discount range (e.g. 70% off or more).

            Allowed values: ALL, 1, 2, 3, 4, 5
          required: false
          example: ALL
          schema:
            type: string
            default: ALL
        - name: brands
          in: query
          description: >-
            Return deals with products by specific brands. Multiple brands can
            be specified separated by comma (,). In addition, brand names can be
            found under the Brand filter on the filter/refinements panel on
            https://www.amazon.com/deals (when applicable).


            Examples:

            AQUA CREST

            Daixers,Antarctic Star
          required: false
          schema:
            type: string
        - name: prime_early_access
          in: query
          description: Only return prime early access deals.
          required: false
          schema:
            type: boolean
        - name: prime_exclusive
          in: query
          description: Only return prime exclusive deals.
          required: false
          schema:
            type: boolean
        - name: lightning_deals
          in: query
          description: Only return lightning deals
          required: false
          schema:
            type: boolean
        - name: language
          in: query
          description: >-
            The language of the results. In case not specified, results will be
            returned in the default domain language.

            Supported languages per country:

            US: en_US, es_US

            AU: en_AU

            BR: pt_BR

            CA: en_CA, fr_CA

            FR: fr_FR, en_GB

            DE: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK

            IN: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN

            IT: it_IT, en_GB

            MX: es_MX

            NL: nl_NL, en_GB

            SG: en_SG

            ES: es_ES, pt_PT, en_GB

            TR: tr_TR

            AE: en_AE, ar_AE

            GB: en_GB

            JP: ja_JP, en_US, zh_CN

            SA: ar_AE, en_AE

            PL: pl_PL

            SE: sv_SE, en_GB

            BE: fr_BE, nl_BE, en_GB

            EG: ar_AE, en_AE

            ZA: en_ZA

            IE: en_IE
          required: false
          schema:
            type: string
        - name: fields
          in: query
          description: >-
            A comma separated list of deal fields to include in the response
            (field projection). By default all fields are returned.


            Example: deal_type,deal_title,deal_ends_at,savings_amount
          required: false
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties: {}
              example:
                code: 0
                message: success
                data:
                  deals:
                    - deal_id: a2c250a5
                      deal_type: BEST_DEAL
                      deal_title: >-
                        Samsung Galaxy S26 Ultra, Unlocked Android Smartphone +
                        $200 Gift Card, 512GB, Privacy Display, Galaxy AI, AI
                        Camera, Super Fast Charging 3.0, Durable Battery, 2026,
                        Cobalt Violet
                      deal_photo: https://m.media-amazon.com/images/I/61gvb-3EjrL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/Samsung-Unlocked-Android-Smartphone-Charging/dp/B0GGT7CXF5
                      canonical_deal_url: https://www.amazon.com/deal/a2c250a5
                      deal_starts_at: '2026-02-25T18:00:00.000Z'
                      deal_ends_at: '2026-03-11T06:59:59.000Z'
                      deal_price:
                        amount: '1299.99'
                        currency: USD
                      list_price:
                        amount: '1699.99'
                        currency: USD
                      savings_percentage: 24
                      savings_amount:
                        amount: '400.0'
                        currency: USD
                      deal_badge: 24% off
                      type: SINGLE_ITEM
                      product_asin: B0GGT7CXF5
                    - deal_id: 8d63397f
                      deal_type: BEST_DEAL
                      deal_title: >-
                        acer Aspire 16 AI Copilot+ PC | 16" WUXGA 120Hz
                        Multi-Touch Display | Snapdragon X X1-26-100 | NPU: 45
                        Tops - GPU: Up to 1.7 TFLOPs | 16GB LPDDR5X | 512GB PCIe
                        Gen 4 SSD | Wi-Fi 7 | A16-11MT-X669
                      deal_photo: https://m.media-amazon.com/images/I/71NoF2JV5oL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/Copilot-Multi-Touch-Display-Snapdragon-X1-26-100/dp/B0F196M26K
                      canonical_deal_url: https://www.amazon.com/deal/8d63397f
                      deal_starts_at: '2026-03-04T08:00:00.000Z'
                      deal_ends_at: '2026-04-01T06:59:59.000Z'
                      deal_price:
                        amount: '549.99'
                        currency: USD
                      list_price:
                        amount: '699.99'
                        currency: USD
                      savings_percentage: 21
                      savings_amount:
                        amount: '150.0'
                        currency: USD
                      deal_badge: 21% off
                      type: SINGLE_ITEM
                      product_asin: B0F196M26K
                    - deal_id: 73345f37
                      deal_type: BEST_DEAL
                      deal_title: >-
                        Bose QuietComfort Ultra Bluetooth Headphones (2nd Gen),
                        Wireless Headphones with Spatial Audio, Over Ear Noise
                        Cancelling with Mic, Up to 30 Hours of Play time, Black
                      deal_photo: https://m.media-amazon.com/images/I/51revx-zToL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/Bose-QuietComfort-Bluetooth-Headphones-Cancelling/dp/B0FDKR293G
                      canonical_deal_url: https://www.amazon.com/deal/73345f37
                      deal_starts_at: '2026-03-06T05:00:00.000Z'
                      deal_ends_at: '2026-03-07T05:00:00.000Z'
                      deal_price:
                        amount: '399.0'
                        currency: USD
                      list_price:
                        amount: '449.0'
                        currency: USD
                      savings_percentage: 11
                      savings_amount:
                        amount: '50.0'
                        currency: USD
                      deal_badge: 11% off
                      type: SINGLE_ITEM
                      product_asin: B0FDKR293G
                    - deal_id: 722d5aef
                      deal_type: BEST_DEAL
                      deal_title: >-
                        UMN King Size Mattress, 12 Inch King Mattress in a Box,
                        Individually Pocketed Springs, Pressure Relief, Motion
                        Isolation, Provides Support, CertiPUR-US Certified,
                        Medium Firm
                      deal_photo: https://m.media-amazon.com/images/I/81QpaaMoMML.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/UMN-Individually-Isolation-CertiPUR-US-Certified/dp/B0DQTSCVKS
                      canonical_deal_url: https://www.amazon.com/deal/722d5aef
                      deal_starts_at: '2026-02-25T08:00:00.000Z'
                      deal_ends_at: '2026-03-11T06:59:59.000Z'
                      deal_price:
                        amount: '179.98'
                        currency: USD
                      list_price:
                        amount: '239.99'
                        currency: USD
                      savings_percentage: 25
                      savings_amount:
                        amount: '60.01'
                        currency: USD
                      deal_badge: 25% off
                      type: SINGLE_ITEM
                      product_asin: B0DQTSCVKS
                    - deal_id: '44756452'
                      deal_type: BEST_DEAL
                      deal_title: >-
                        Ring Battery Doorbell with Ring Indoor Cam 2nd Gen
                        (Black)
                      deal_photo: https://m.media-amazon.com/images/I/61CzWvbBMcL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/All-new-Ring-Battery-Doorbell-Indoor/dp/B0D931YTT2
                      canonical_deal_url: https://www.amazon.com/deal/44756452
                      deal_starts_at: '2026-03-04T05:00:00.000Z'
                      deal_ends_at: '2026-04-01T04:00:00.000Z'
                      deal_price:
                        amount: '69.99'
                        currency: USD
                      list_price:
                        amount: '139.99'
                        currency: USD
                      savings_percentage: 50
                      savings_amount:
                        amount: '70.0'
                        currency: USD
                      deal_badge: 50% off
                      type: SINGLE_ITEM
                      product_asin: B0D931YTT2
                    - deal_id: '20e24360'
                      deal_type: BEST_DEAL
                      deal_title: >-
                        Amazon Fire TV Stick 4K Select (newest model), start
                        streaming in 4K, AI-powered search, and free & live TV
                      deal_photo: https://m.media-amazon.com/images/I/61r3G3vAhBL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/amazon-fire-tv-stick-4K-select/dp/B0C6W3D4RM
                      canonical_deal_url: https://www.amazon.com/deal/20e24360
                      deal_starts_at: '2026-02-27T08:00:00.000Z'
                      deal_ends_at: '2026-03-08T07:59:59.000Z'
                      deal_price:
                        amount: '19.99'
                        currency: USD
                      list_price:
                        amount: '39.99'
                        currency: USD
                      savings_percentage: 50
                      savings_amount:
                        amount: '20.0'
                        currency: USD
                      deal_badge: 50% off
                      type: SINGLE_ITEM
                      product_asin: B0C6W3D4RM
                    - deal_id: aaaef6d8
                      deal_type: DEAL_OF_THE_DAY
                      deal_title: >-
                        Samsung Galaxy Buds 4 Pro (2026) AI True Wireless
                        Bluetooth Earbuds + $30 Gift Card, Hi-Res Audio, 2-Way
                        Speaker, ANC 2.0, Optimized Comfort, IP57, Live
                        Translation, Black [US Version, 2 Yr Warranty]
                      deal_photo: https://m.media-amazon.com/images/I/61VHIeEkfYL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/Samsung-Wireless-Bluetooth-Optimized-Translation/dp/B0GLM8GZQW
                      canonical_deal_url: https://www.amazon.com/deal/aaaef6d8
                      deal_starts_at: '2026-02-25T18:00:00.000Z'
                      deal_ends_at: '2026-03-11T06:59:59.000Z'
                      deal_price:
                        amount: '249.99'
                        currency: USD
                      list_price:
                        amount: '279.99'
                        currency: USD
                      savings_percentage: 11
                      savings_amount:
                        amount: '30.0'
                        currency: USD
                      deal_badge: 11% off
                      type: SINGLE_ITEM
                      product_asin: B0GLM8GZQW
                    - deal_id: 7aa445fd
                      deal_type: BEST_DEAL
                      deal_title: >-
                        Air Purifiers for Home Large Room, Cover Up to 2600 Ft²
                        with Washable Filters, Powerful Turbo Mode, PM2.5 Air
                        Quality Display, 22dB Sleep Mode, Air Cleaner for Pets
                        Hair, Smoke, Odors, HAP607, White
                      deal_photo: https://m.media-amazon.com/images/I/81UqyMTJPqL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/Purifiers-Washable-Filters-Powerful-Quality/dp/B0GCZNJ1P8
                      canonical_deal_url: https://www.amazon.com/deal/7aa445fd
                      deal_starts_at: '2026-03-02T08:00:00.000Z'
                      deal_ends_at: '2026-03-16T06:59:59.000Z'
                      deal_price:
                        amount: '89.99'
                        currency: USD
                      list_price:
                        amount: '326.99'
                        currency: USD
                      savings_percentage: 72
                      savings_amount:
                        amount: '237.0'
                        currency: USD
                      deal_badge: 72% off
                      type: SINGLE_ITEM
                      product_asin: B0GCZNJ1P8
                    - deal_id: 8c9f3302
                      deal_type: BEST_DEAL
                      deal_title: >-
                        TOCOL for iPhone 16 Plus Screen Protector/iPhone 15 Plus
                        Screen Protector 9H Hardness Military Grade Shatterproof
                        HD Tempered Glass Full Coverage Easy Installation Case
                        Friendly 2 Pack
                      deal_photo: https://m.media-amazon.com/images/I/71k72VXvtQL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/TOCOL-iPhone-16-Shatterproof-Installation/dp/B0DQTVHDTY
                      canonical_deal_url: https://www.amazon.com/deal/8c9f3302
                      deal_starts_at: '2026-02-21T08:00:00.000Z'
                      deal_ends_at: '2026-03-07T07:59:59.000Z'
                      deal_price:
                        amount: '9.49'
                        currency: USD
                      list_price:
                        amount: '11.99'
                        currency: USD
                      savings_percentage: 21
                      savings_amount:
                        amount: '2.5'
                        currency: USD
                      deal_badge: 21% off
                      type: SINGLE_ITEM
                      product_asin: B0DQTVHDTY
                    - deal_id: 2184b63f
                      deal_type: BEST_DEAL
                      deal_title: >-
                        BNX TruFilter 16x20x1 Air Filter MERV 13 (6-Pack) - MADE
                        IN USA - Electrostatic Pleated Air Conditioner HVAC AC
                        Furnace Filters for Allergies, Pollen, Mold, Bacteria,
                        Smoke, Allergen, MPR 1900 FPR 10
                      deal_photo: https://m.media-amazon.com/images/I/71-9pwGRr0L.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/BNX-16x20x1-MERV-Filter-Pack/dp/B09XFLX5SD
                      canonical_deal_url: https://www.amazon.com/deal/2184b63f
                      deal_starts_at: '2026-02-28T08:00:00.000Z'
                      deal_ends_at: '2026-03-14T06:59:59.000Z'
                      deal_price:
                        amount: '47.19'
                        currency: USD
                      list_price:
                        amount: '60.49'
                        currency: USD
                      savings_percentage: 22
                      savings_amount:
                        amount: '13.3'
                        currency: USD
                      deal_badge: 22% off
                      type: SINGLE_ITEM
                      product_asin: B09XFLX5SD
                    - deal_id: '20e24360'
                      deal_type: BEST_DEAL
                      deal_title: >-
                        Amazon Fire TV Stick 4K Max streaming device, with
                        AI-powered Fire TV Search, supports Wi-Fi 6E, free &
                        live TV without cable or satellite
                      deal_photo: https://m.media-amazon.com/images/I/61KoIgcXSKL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/all-new-amazon-fire-tv-stick-4k-max/dp/B0BP9SNVH9
                      canonical_deal_url: https://www.amazon.com/deal/20e24360
                      deal_starts_at: '2026-02-27T08:00:00.000Z'
                      deal_ends_at: '2026-03-08T07:59:59.000Z'
                      deal_price:
                        amount: '39.99'
                        currency: USD
                      list_price:
                        amount: '59.99'
                        currency: USD
                      savings_percentage: 33
                      savings_amount:
                        amount: '20.0'
                        currency: USD
                      deal_badge: 33% off
                      type: SINGLE_ITEM
                      product_asin: B0BP9SNVH9
                    - deal_id: 136c1096
                      deal_type: BEST_DEAL
                      deal_title: >-
                        SUPFINE Magnetic for iPhone 17 Pro Max Case (Compatible
                        with MagSafe)(Military Grade Drop Protection)
                        Translucent Matte Shockproof with Anti-Fingerprint Phone
                        Cover, Black
                      deal_photo: https://m.media-amazon.com/images/I/71NukmNYUyL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/SUPFINE-Pro-Max-Case-Anti-Fingerprint/dp/B0FH655984
                      canonical_deal_url: https://www.amazon.com/deal/136c1096
                      deal_starts_at: '2026-03-02T08:00:00.000Z'
                      deal_ends_at: '2026-03-16T06:59:59.000Z'
                      deal_price:
                        amount: '5.59'
                        currency: USD
                      list_price:
                        amount: '9.99'
                        currency: USD
                      savings_percentage: 44
                      savings_amount:
                        amount: '4.4'
                        currency: USD
                      deal_badge: 44% off
                      type: SINGLE_ITEM
                      product_asin: B0FH655984
                    - deal_id: 3cf147f7
                      deal_type: BEST_DEAL
                      deal_title: >-
                        Anker SOLIX C1000 Gen 2 Portable Power Station, 2,000W
                        (Peak 3,000W) Solar Generator, Full Charge in 49 Min,
                        1,024Wh LiFePO4 Battery for Home Backup, Power Outages,
                        and Camping (Optional Solar Panel)
                      deal_photo: https://m.media-amazon.com/images/I/71MTJMuNQQL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/Anker-Portable-Station-Generator-Optional/dp/B0FN7MSY4L
                      canonical_deal_url: https://www.amazon.com/deal/3cf147f7
                      deal_starts_at: '2026-02-27T08:00:00.000Z'
                      deal_ends_at: '2026-03-13T06:59:59.000Z'
                      deal_price:
                        amount: '428.99'
                        currency: USD
                      list_price:
                        amount: '799.0'
                        currency: USD
                      savings_percentage: 46
                      savings_amount:
                        amount: '370.01'
                        currency: USD
                      deal_badge: 46% off
                      type: SINGLE_ITEM
                      product_asin: B0FN7MSY4L
                    - deal_id: 93a97cc4
                      deal_type: BEST_DEAL
                      deal_title: >-
                        TERUNSOUl 4K+4K Dash Cam Front and Rear, Free 128GB Card
                        Included, 5.8GHz WiFi Dash Camera for Cars, Built-in
                        GPS, G-Sensor, 170°Wide Angle, 3" IPS Screen, 24H
                        Parking Mode, Support 512GB Max
                      deal_photo: https://m.media-amazon.com/images/I/81oa74mGntL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/TERUNSOUl-Included-G-Sensor-170%C2%B0Wide-Parking/dp/B0FC6S2R7K
                      canonical_deal_url: https://www.amazon.com/deal/93a97cc4
                      deal_starts_at: '2026-03-03T08:05:00.000Z'
                      deal_ends_at: '2026-03-17T06:55:00.000Z'
                      deal_price:
                        amount: '109.98'
                        currency: USD
                      list_price:
                        amount: '183.0'
                        currency: USD
                      savings_percentage: 40
                      savings_amount:
                        amount: '73.02'
                        currency: USD
                      deal_badge: 40% off
                      type: SINGLE_ITEM
                      product_asin: B0FC6S2R7K
                    - deal_id: e29f9037
                      deal_type: BEST_DEAL
                      deal_title: >-
                        FDW | 8 Inch Twin Mattress | Medium Firm | Gel Memory
                        Foam Mattress | White | Bed in a Box, CertiPUR-US
                        Certified | Pressure Relief, Cooling Ventilated Foam |
                        Washable Removable Cover
                      deal_photo: https://m.media-amazon.com/images/I/61ljIv7yZIL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/Memory-Foam-Mattress-Mattresses-CertiPUR-US/dp/B08YDJS51B
                      canonical_deal_url: https://www.amazon.com/deal/e29f9037
                      deal_starts_at: '2026-03-01T08:00:00.000Z'
                      deal_ends_at: '2026-03-11T06:45:00.000Z'
                      deal_price:
                        amount: '76.46'
                        currency: USD
                      list_price:
                        amount: '159.99'
                        currency: USD
                      savings_percentage: 52
                      savings_amount:
                        amount: '83.53'
                        currency: USD
                      deal_badge: 52% off
                      type: SINGLE_ITEM
                      product_asin: B08YDJS51B
                    - deal_id: 272f88a7
                      deal_type: BEST_DEAL
                      deal_title: >-
                        KNKA Air Purifier for Home Bedroom Large Room Up to
                        1,695 Ft² Once Per Hour, HEPA Air Cleaner with Washable
                        Pre-Filter, AHAM VERIFIDE, AQI Display, ECO Mode, Pet
                        Mode for Pets, Dust, Pollen, APH4000
                      deal_photo: https://m.media-amazon.com/images/I/71eM07+OB6L.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/KNKA-Purifier-Pre-Filter-Allergies-APH4000/dp/B0FNDG2TNK
                      canonical_deal_url: https://www.amazon.com/deal/272f88a7
                      deal_starts_at: '2026-03-04T08:05:00.000Z'
                      deal_ends_at: '2026-03-11T06:55:00.000Z'
                      deal_price:
                        amount: '119.99'
                        currency: USD
                      list_price:
                        amount: '259.99'
                        currency: USD
                      savings_percentage: 54
                      savings_amount:
                        amount: '140.0'
                        currency: USD
                      deal_badge: 54% off
                      type: SINGLE_ITEM
                      product_asin: B0FNDG2TNK
                    - deal_id: 5bf9c9ae
                      deal_type: BEST_DEAL
                      deal_title: >-
                        Breville Barista Pro Espresso Machine BES878BSS, Brushed
                        Stainless Steel
                      deal_photo: https://m.media-amazon.com/images/I/71FBZj9tisL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/Breville-Barista-Pro-Automatic-Integrated/dp/B08133HX34
                      canonical_deal_url: https://www.amazon.com/deal/5bf9c9ae
                      deal_starts_at: '2026-03-02T21:30:00.000Z'
                      deal_ends_at: '2026-03-15T06:59:59.000Z'
                      deal_price:
                        amount: '649.95'
                        currency: USD
                      list_price:
                        amount: '849.95'
                        currency: USD
                      savings_percentage: 24
                      savings_amount:
                        amount: '200.0'
                        currency: USD
                      deal_badge: 24% off
                      type: SINGLE_ITEM
                      product_asin: B08133HX34
                    - deal_id: '814411e4'
                      deal_type: BEST_DEAL
                      deal_title: >-
                        BISSELL Little Green Multi-Purpose Portable Carpet and
                        Upholstery Cleaner, Car and Auto Detailer, with
                        Exclusive Specialty Tools, Green, 1400B
                      deal_photo: https://m.media-amazon.com/images/I/717X5secGjL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/Bissell-Multi-Purpose-Portable-Upholstery-1400B/dp/B0016HF5GK
                      canonical_deal_url: https://www.amazon.com/deal/814411e4
                      deal_starts_at: '2026-02-08T08:00:00.000Z'
                      deal_ends_at: '2026-03-08T07:59:59.000Z'
                      deal_price:
                        amount: '99.99'
                        currency: USD
                      list_price:
                        amount: '129.99'
                        currency: USD
                      savings_percentage: 23
                      savings_amount:
                        amount: '30.0'
                        currency: USD
                      deal_badge: 23% off
                      type: SINGLE_ITEM
                      product_asin: B0016HF5GK
                    - deal_id: 3efd1d98
                      deal_type: BEST_DEAL
                      deal_title: >-
                        LetsJoli Bras for Women Supportive Wireless Push Up Bra
                        Full Coverage No Underwire Seamless Plus Size for Older
                        Women
                      deal_photo: https://m.media-amazon.com/images/I/61bWdCuPmYL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/LetsJoli-Supportive-Wireless-Underwear-Women%EF%BC%88Black/dp/B0F6V6MKC9
                      canonical_deal_url: https://www.amazon.com/deal/3efd1d98
                      deal_starts_at: '2026-03-02T08:00:00.000Z'
                      deal_ends_at: '2026-03-16T06:59:59.000Z'
                      deal_price:
                        amount: '19.97'
                        currency: USD
                      list_price:
                        amount: '26.99'
                        currency: USD
                      savings_percentage: 26
                      savings_amount:
                        amount: '7.02'
                        currency: USD
                      deal_badge: 26% off
                      type: SINGLE_ITEM
                      product_asin: B0F6V6MKC9
                    - deal_id: faa2e6e3
                      deal_type: BEST_DEAL
                      deal_title: >-
                        Google Pixel 10a - Lavender - 128 GB with $100 Amazon
                        Gift Card
                      deal_photo: https://m.media-amazon.com/images/I/71bW-tqJTnL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/Google-Pixel-10a-Lavender-Amazon/dp/B0GJ7GZMRL
                      canonical_deal_url: https://www.amazon.com/deal/faa2e6e3
                      deal_starts_at: '2026-02-20T08:00:00.000Z'
                      deal_ends_at: '2026-03-21T06:59:59.000Z'
                      deal_price:
                        amount: '499.0'
                        currency: USD
                      list_price:
                        amount: '599.0'
                        currency: USD
                      savings_percentage: 17
                      savings_amount:
                        amount: '100.0'
                        currency: USD
                      deal_badge: 17% off
                      type: SINGLE_ITEM
                      product_asin: B0GJ7GZMRL
                    - deal_id: 9afc3431
                      deal_type: BEST_DEAL
                      deal_title: >-
                        Bedsure Queen Sheet Set, Cooling Sheets for Queen Size
                        Bed Set, Rayon Derived from Bamboo, Breathable & Soft,
                        Deep Pocket Up to 16 Inches, Hotel Luxury Silky Bedding
                        for Hot Sleepers, White
                      deal_photo: https://m.media-amazon.com/images/I/81L2xb5ly6L.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/Bedsure-Cooling-Sheets-Breathable-Silk-Like/dp/B07YK8VTJV
                      canonical_deal_url: https://www.amazon.com/deal/9afc3431
                      deal_starts_at: '2026-03-02T08:00:00.000Z'
                      deal_ends_at: '2026-03-09T06:59:59.000Z'
                      deal_price:
                        amount: '54.99'
                        currency: USD
                      list_price:
                        amount: '78.99'
                        currency: USD
                      savings_percentage: 30
                      savings_amount:
                        amount: '24.0'
                        currency: USD
                      deal_badge: 30% off
                      type: SINGLE_ITEM
                      product_asin: B07YK8VTJV
                    - deal_id: 64d2404a
                      deal_type: BEST_DEAL
                      deal_title: >-
                        Shark Upright Vacuum, Navigator Lift-Away Deluxe with
                        Large Dust Cup Capacity, HEPA Filter, Swivel Steering,
                        Upholstery Tool & Crevice Tool, Blue, NV360
                      deal_photo: https://m.media-amazon.com/images/I/61w1n9p2R0L.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/Shark-Navigator-Professional-Anti-Allergy-NV360/dp/B00JH98GR4
                      canonical_deal_url: https://www.amazon.com/deal/64d2404a
                      deal_starts_at: '2026-02-22T08:00:00.000Z'
                      deal_ends_at: '2026-03-08T05:00:00.000Z'
                      deal_price:
                        amount: '129.99'
                        currency: USD
                      list_price:
                        amount: '149.99'
                        currency: USD
                      savings_percentage: 13
                      savings_amount:
                        amount: '20.0'
                        currency: USD
                      deal_badge: 13% off
                      type: SINGLE_ITEM
                      product_asin: B00JH98GR4
                    - deal_id: 70391cbf
                      deal_type: BEST_DEAL
                      deal_title: >-
                        Coop Home Goods Original Adjustable Pillow, Queen Size
                        Bed Pillows for Sleeping, Cross Cut Memory Foam Pillows
                        - Medium Firm Back, Stomach and Side Sleeper Pillow,
                        CertiPUR-US/GREENGUARD Gold
                      deal_photo: https://m.media-amazon.com/images/I/61hiruVCYbL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/Coop-Home-Goods-Memory-Foam-Pillow-For-Side-Back-Stomach-Sleeper/dp/B00EINBSEW
                      canonical_deal_url: https://www.amazon.com/deal/70391cbf
                      deal_starts_at: '2026-03-02T08:00:00.000Z'
                      deal_ends_at: '2026-03-09T06:59:59.000Z'
                      deal_price:
                        amount: '71.2'
                        currency: USD
                      list_price:
                        amount: '89.0'
                        currency: USD
                      savings_percentage: 20
                      savings_amount:
                        amount: '17.8'
                        currency: USD
                      deal_badge: 20% off
                      type: SINGLE_ITEM
                      product_asin: B00EINBSEW
                    - deal_id: 3b1bd614
                      deal_type: BEST_DEAL
                      deal_title: >-
                        ASUS ROG Swift 32” 4K OLED Gaming Monitor (PG32UCDM) -
                        UHD (3840 x 2160), QD-OLED, 240Hz, 0.03ms, G-SYNC
                        Compatible, Custom Heatsink, Graphene Film, 99% DCI-P3,
                        True 10-bit, 90W USB-C
                      deal_photo: https://m.media-amazon.com/images/I/91t16+g29KL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/ASUS-Swift-Gaming-Monitor-PG32UCDM/dp/B0CV26XVMD
                      canonical_deal_url: https://www.amazon.com/deal/3b1bd614
                      deal_starts_at: '2026-03-02T08:00:00.000Z'
                      deal_ends_at: '2026-03-16T06:59:59.000Z'
                      deal_price:
                        amount: '999.0'
                        currency: USD
                      list_price:
                        amount: '1299.0'
                        currency: USD
                      savings_percentage: 23
                      savings_amount:
                        amount: '300.0'
                        currency: USD
                      deal_badge: 23% off
                      type: SINGLE_ITEM
                      product_asin: B0CV26XVMD
                    - deal_id: 2f7c24a7
                      deal_type: BEST_DEAL
                      deal_title: >-
                        Bose QuietComfort Headphones - Wireless Bluetooth
                        Headphones, Active Over Ear Noise Cancelling and Mic,
                        USB-C Charging, Deep Bass, Up to 24 Hours of Playtime,
                        Twilight Blue - Limited Edition Color
                      deal_photo: https://m.media-amazon.com/images/I/51tItfLj8xL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/Bose-QuietComfort-Bluetooth-Headphones-Cancelling/dp/B0DZHR44J9
                      canonical_deal_url: https://www.amazon.com/deal/2f7c24a7
                      deal_starts_at: '2026-02-27T08:00:00.000Z'
                      deal_ends_at: '2026-03-09T06:59:59.000Z'
                      deal_price:
                        amount: '229.0'
                        currency: USD
                      list_price:
                        amount: '349.0'
                        currency: USD
                      savings_percentage: 34
                      savings_amount:
                        amount: '120.0'
                        currency: USD
                      deal_badge: 34% off
                      type: SINGLE_ITEM
                      product_asin: B0DZHR44J9
                    - deal_id: c99ee172
                      deal_type: BEST_DEAL
                      deal_title: >-
                        High Pressure Rain Shower Head: Upgrade Shower Heads
                        with Handheld Spray Combo with Fixed Showerhead and 10
                        Sprays Handheld Shower Head, Detachable Showerheads
                        Built-in Magnetic Docking and Power Jets
                      deal_photo: https://m.media-amazon.com/images/I/711Ix4QGbJL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/High-Pressure-Rain-Shower-Built/dp/B0DQHFG94H
                      canonical_deal_url: https://www.amazon.com/deal/c99ee172
                      deal_starts_at: '2026-03-02T08:00:00.000Z'
                      deal_ends_at: '2026-03-16T06:59:59.000Z'
                      deal_price:
                        amount: '49.96'
                        currency: USD
                      list_price:
                        amount: '79.99'
                        currency: USD
                      savings_percentage: 38
                      savings_amount:
                        amount: '30.03'
                        currency: USD
                      deal_badge: 38% off
                      type: SINGLE_ITEM
                      product_asin: B0DQHFG94H
                    - deal_id: 1d6af4f4
                      deal_type: BEST_DEAL
                      deal_title: >-
                        Coway Airmega AP-1512HH(W) True HEPA Purifier with Air
                        Quality Monitoring, Auto, Timer, Filter Indicator, and
                        Eco Mode, 16.8 x 18.3 x 9.7, White
                      deal_photo: https://m.media-amazon.com/images/I/61Cgh4ol4oL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/Coway-AP-1512HH-Mighty-Purifier-White/dp/B01728NLRG
                      canonical_deal_url: https://www.amazon.com/deal/1d6af4f4
                      deal_starts_at: '2026-02-13T08:00:00.000Z'
                      deal_ends_at: '2026-03-16T06:59:59.000Z'
                      deal_price:
                        amount: '154.99'
                        currency: USD
                      list_price:
                        amount: '229.99'
                        currency: USD
                      savings_percentage: 33
                      savings_amount:
                        amount: '75.0'
                        currency: USD
                      deal_badge: 33% off
                      type: SINGLE_ITEM
                      product_asin: B01728NLRG
                    - deal_id: '20e24360'
                      deal_type: BEST_DEAL
                      deal_title: >-
                        Amazon Fire TV Stick 4K Plus (newest model) with
                        AI-powered Fire TV Search, Wi-Fi 6, stream over 1.8
                        million movies and shows, free & live TV
                      deal_photo: https://m.media-amazon.com/images/I/51WtNy0OxLL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/Amazon-newest-AI-powered-Search-million/dp/B0F7Z4QZTT
                      canonical_deal_url: https://www.amazon.com/deal/20e24360
                      deal_starts_at: '2026-02-27T08:00:00.000Z'
                      deal_ends_at: '2026-03-08T07:59:59.000Z'
                      deal_price:
                        amount: '29.99'
                        currency: USD
                      list_price:
                        amount: '49.99'
                        currency: USD
                      savings_percentage: 40
                      savings_amount:
                        amount: '20.0'
                        currency: USD
                      deal_badge: 40% off
                      type: SINGLE_ITEM
                      product_asin: B0F7Z4QZTT
                    - deal_id: '58151838'
                      deal_type: BEST_DEAL
                      deal_title: >-
                        Soundcore by Anker Q20i Hybrid Active Noise Cancelling
                        Headphones, Wireless Over-Ear Bluetooth, 40H Long ANC
                        Playtime, Hi-Res Audio, Big Bass, Customize via an App,
                        Transparency Mode
                      deal_photo: https://m.media-amazon.com/images/I/51CnDMbXZzL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/soundcore-Cancelling-Headphones-Bluetooth-Transparency/dp/B0C3HCD34R
                      canonical_deal_url: https://www.amazon.com/deal/58151838
                      deal_starts_at: '2026-03-02T08:00:00.000Z'
                      deal_ends_at: '2026-03-16T06:59:59.000Z'
                      deal_price:
                        amount: '39.99'
                        currency: USD
                      list_price:
                        amount: '69.99'
                        currency: USD
                      savings_percentage: 43
                      savings_amount:
                        amount: '30.0'
                        currency: USD
                      deal_badge: 43% off
                      type: SINGLE_ITEM
                      product_asin: B0C3HCD34R
                    - deal_id: df2ea0f4
                      deal_type: BEST_DEAL
                      deal_title: >-
                        Wireless Headset with Mic for Work, Bluetooth Headset
                        with Microphone (Noise Cancelling & Mute Button),
                        Wireless Headphones with Mic for Work from
                        Home/Office/PC/Call Center/Computer/Laptop/Teams/Zoom
                      deal_photo: https://m.media-amazon.com/images/I/61re+l9kDhL.jpg
                      deal_state: AVAILABLE
                      deal_url: >-
                        https://www.amazon.com/LEVN-Wireless-Bluetooth-Microphone-Cancelling/dp/B0DHH5WJSF
                      canonical_deal_url: https://www.amazon.com/deal/df2ea0f4
                      deal_starts_at: '2026-02-23T08:05:00.000Z'
                      deal_ends_at: '2026-03-09T06:55:00.000Z'
                      deal_price:
                        amount: '69.44'
                        currency: USD
                      list_price:
                        amount: '89.99'
                        currency: USD
                      savings_percentage: 23
                      savings_amount:
                        amount: '20.55'
                        currency: USD
                      deal_badge: 23% off
                      type: SINGLE_ITEM
                      product_asin: B0DHH5WJSF
                  total_deals: 500
                  country: US
                  domain: www.amazon.com
                requestId: 722839d5-d6e3-4dcb-b3af-7664cc85f093
          headers: {}
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 400
                  data: null
                  message: 'Missing required parameter: handle'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 401
                  data: null
                  message: apiKey is null
        '402':
          description: Payment Required
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 402
                  data: null
                  message: apiKey quota is not enough
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 429
                  data: null
                  message: qps limit exceeded
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                example:
                  code: 500
                  data: null
                  message: Internal server error
      deprecated: false
      security:
        - JWT Bearer: []
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |-
            curl --request GET \
              --url 'https://api.keyapi.ai/v1/amazon/deals?country=us&offset=0&min_product_star_rating=ALL&price_range=ALL&discount_range=ALL' \
              --header 'Authorization: Bearer <YOUR_API_KEY>'
        - lang: python
          label: Python
          source: |-
            import requests

            response = requests.get(
                'https://api.keyapi.ai/v1/amazon/deals',
                params={"country": "us", "offset": 0, "min_product_star_rating": "ALL", "price_range": "ALL", "discount_range": "ALL"},
                headers={'Authorization': 'Bearer <YOUR_API_KEY>'}
            )
            print(response.json())
        - lang: javascript
          label: JavaScript
          source: >-
            const params = new URLSearchParams({"country": "us", "offset": 0,
            "min_product_star_rating": "ALL", "price_range": "ALL",
            "discount_range": "ALL"});


            const response = await
            fetch(`https://api.keyapi.ai/v1/amazon/deals?${params}`, {
              method: 'GET',
              headers: { 'Authorization': 'Bearer <YOUR_API_KEY>' }
            });

            const data = await response.json();

            console.log(data);
components:
  securitySchemes:
    JWT Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: |-
        API key for authentication. Format: `sk_live_xxxxxxxxxxxxx`
        Get your API key from the [Dashboard](http://keyapi.ai/app/dashboard).

````