# Amazon Deals API

> Amazon Deals API is a paid API for AI agents from agents.openwebninja.com, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Fetches real-time Amazon deals including Today's Deals, Best Deals, and Lightning Deals with filtering by category, brand, rating, deal type, and country.

## Facts

- Endpoint: GET https://agents.openwebninja.com/realtime-amazon-data/deals-v2?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.openwebninja.com
- Website: https://agents.openwebninja.com
- Canonical page: https://www.zero.xyz/c/agents-openwebninja-com-amazon-deals-api-3a980765
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_V93oOQrDTo5elb1C3bv9m

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-openwebninja-com-amazon-deals-api-3a980765
```

Example prompt: Can you pull up today's Lightning Deals and Best Deals on Amazon US in the Electronics and Kitchen categories, filtering for products with at least 4-star ratings?

## When to prefer this

Use this endpoint when you need real-time Amazon deal data across multiple countries and categories, with rich filtering options (brand, category, deal type, star rating). It is preferable over scraping Amazon directly and supports 24 country marketplaces with multilingual output.

## Known failure modes

- Invalid country code returns 400 error
- Unsupported country/delivery_country combination returns 400 error
- Invalid category IDs return empty results or 400
- Offset not a multiple of 30 may return unexpected results
- Rate limiting or authentication failure returns 401/429
- No deals matching filters returns empty deals array

## How this service works

Get Amazon Deals (Today's Deals / Top Deals, Best Deals, and Lightning Deals)  with support for all deal types, filters, and options available on Amazon.

## Output

Returns an array of deal objects each containing the deal title, type (e.g. Lightning Deal, Best Deal), URL, product ASIN, deal state, savings percentage, start/end timestamps, deal badge, and photo URL, plus top-level metadata including the Amazon domain, country, and total deal count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "brands": {
   "type": "string",
   "description": "Return deals with products by specific brands.  \n  Multiple brands can be specified separated by comma (,).  \n  In addition, brand names can be found under the Brand filter on the filter/refinements panel on https://www.amazon.com/deals (when applicable)."
  },
  "fields": {
   "type": "string",
   "description": "A comma separated list of deal fields to include in the response (field projection).  \n  By default all fields are returned."
  },
  "offset": {
   "type": "string",
   "description": "Number of results to skip / index to start from (for pagination). Works with multiples of 30 (like on Amazons deals page) - 0, 30, 60, 90, etc."
  },
  "country": {
   "enum": [
    "US",
    "AU",
    "BR",
    "CA",
    "CN",
    "FR",
    "DE",
    "IN",
    "IT",
    "MX",
    "NL",
    "SG",
    "ES",
    "TR",
    "AE",
    "GB",
    "JP",
    "SA",
    "PL",
    "SE",
    "BE",
    "EG",
    "ZA",
    "IE"
   ],
   "type": "string",
   "default": "US",
   "description": "Sets the Amazon domain, marketplace country, language and currency."
  },
  "language": {
   "type": "string",
   "description": "The language of the results. In case not specified, results will be returned in the default domain language.  \n\n  **Supported languages per country:**  \n  `US`: en_US, es_US  \n  `AU`: en_AU  \n  `BR`: pt_BR  \n  `CA`: en_CA, fr_CA  \n  `FR`: fr_FR, en_GB  \n  `DE`: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK  \n  `IN`: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN  \n  `IT`: it_IT, en_GB  \n  `MX`: es_MX  \n  `NL`: nl_NL, en_GB  \n  `SG`: en_SG  \n  `ES`: es_ES, pt_PT, en_GB  \n  `TR`: tr_TR  \n  `AE`: en_AE, ar_AE  \n  `GB`: en_GB  \n  `JP`: ja_JP, en_US, zh_CN  \n  `SA`: ar_AE, en_AE  \n  `PL`: pl_PL  \n  `SE`: sv_SE, en_GB  \n  `BE`: fr_BE, nl_BE, en_GB  \n  `EG`: ar_AE, en_AE  \n  `ZA`: en_ZA  \n  `IE`: en_IE   "
  },
  "categories": {
   "type": "string",
   "description": "Return deals with products in specific categories / departments.  \n  Multiple categories can be specified as a comma (,) separated list.  \n  Numeric category id's can be found in the URL after selecting a specific category on https://www.amazon.com/deals."
  },
  "price_range": {
   "enum": [
    "ALL",
    "1",
    "2",
    "3",
    "4",
    "5"
   ],
   "type": "string",
   "default": "ALL",
   "description": "Return deals with price within a specific price range.  \n  1 is l
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "data": {
   "type": "object",
   "properties": {
    "deals": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "type": {
        "type": "string",
        "description": "Type classification of the deal"
       },
       "deal_id": {
        "type": "string",
        "description": "Unique identifier for the deal"
       },
       "deal_url": {
        "type": "string",
        "description": "URL to the deal page"
       },
       "deal_type": {
        "type": "string",
        "description": "Type/category of the deal"
       },
       "deal_badge": {
        "type": "string",
        "description": "Badge/label for the deal"
       },
       "deal_photo": {
        "type": "string",
        "description": "URL of the deal image"
       },
       "deal_state": {
        "type": "string",
        "description": "Current state/status of the deal"
       },
       "deal_title": {
        "type": "string",
        "description": "Title/name of the deal"
       },
       "deal_ends_at": {
        "type": "string",
        "description": "End timestamp of the deal"
       },
       "product_asin": {
        "type": "string",
        "description": "ASIN of the product in deal"
       },
       "deal_starts_at": {
        "type": "string",
        "description": "Start timestamp of the deal"
       },
       "canonical_deal_url": {
        "type": "string",
        "description": "Canonical URL for the deal"
       },
       "savings_percentage": {
        "type": "integer",
        "description": "Percentage discount offered"
       }
      }
     }
    },
    "domain": {
     "type": "string",
     "description": "Amazon marketplace domain"
    },
    "country": {
     "type": "string",
     "description": "Country code for the deals"
    },
    "total_deals": {
     "type": "string",
     "nullable": true,
     "description": "Total number of deals (null if not available)"
    }
   }
  },
  "status": {
   "type": "string",
   "description": "Status of the API response"
  },
  "request_id": {
   "type": "string",
   "description": "Unique identifier for the API request"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-openwebninja-com-amazon-deals-api-3a980765/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.openwebninja.com](https://www.zero.xyz/host/agents.openwebninja.com/llms.txt)
