GET /api/amazon/deals — Amazon Deals Feed

The deals endpoint surfaces active Amazon deals — including lightning deals, limited-time offers, and promotional discounts — across all supported marketplaces. Each deal result includes the discount percentage, deal type, current and list prices, and timing metadata so you can display countdowns or highlight urgency in your UI.

Request

string

default:"US"

The Amazon marketplace to query. Supported values: US, UK, CA, DE, FR, IT, ES, AU, IN, MX, BR, JP, PL. Defaults to US.

string

Comma-separated list of Amazon category IDs to filter deals by (e.g., "172282,16225009011"). Use the bestseller-categories endpoint to look up valid category IDs.

integer

Page number to retrieve. Combine with pageInfo.totalPages in the response to paginate through all available deals.

integer

Number of deal results to return per page.

Example request

curl "https://api.glade.dev/api/amazon/deals?domain=US&page=1" \
  -H "API-KEY: YOUR_API_KEY"

Response

A successful response returns data.amazonDeals.productResults containing an array of deal products and pagination metadata.

object

Hide properties

object

Show properties

array

Array of deal product objects.

Show results[]

string

Full product title as shown on Amazon.

string

Canonical Amazon product page URL.

string

Amazon Standard Identification Number for the product. Matches the pattern ^[A-Z0-9]{10}$.

object

Standard product price object.

Show properties

string

Currency symbol (e.g., "$").

number

Numeric price value.

string

ISO 4217 currency code (e.g., "USD").

string

Human-readable price string (e.g., "$89.99").

string

URL of the product’s primary image.

number

Average customer rating out of 5.

integer

Total number of customer ratings.

object | null

Manufacturer’s suggested retail price, if available.

Show properties

string

Currency symbol.

number

Numeric RRP value.

string

ISO 4217 currency code.

string

Human-readable RRP string.

string

Unique identifier for this deal, assigned by Amazon.

string

Direct URL to the deal page on Amazon.

object

The price at which this deal is offered.

Show properties

string

Currency symbol.

number

Deal price value.

string

ISO 4217 currency code.

string

Human-readable deal price (e.g., "$89.99").

object

The current active price of the deal (may differ from dealPrice if claimed partially).

Show properties

string

Currency symbol.

number

Current price value.

string

ISO 4217 currency code.

string

Human-readable current price.

object

The original list price before the deal discount.

Show properties

string

Currency symbol.

number

List price value.

string

ISO 4217 currency code.

string

Human-readable list price.

number

Percentage discount applied by this deal (e.g., 35 means 35% off).

string

Type of deal (e.g., "LIGHTNING_DEAL", "BEST_DEAL", "COUPON").

boolean

true if this is a time-limited lightning deal.

string

Promotional badge label if present (e.g., "Deal of the Day").

string

ISO 8601 timestamp for when the deal starts. Present for lightning deals.

string

ISO 8601 timestamp for when the deal ends. Present for lightning deals.

object

Show properties

integer

The current page number returned.

integer

Total number of pages available.

integer

Total number of active deals matching the query.

boolean

true if there is a subsequent page of results.

boolean

true if there is a previous page of results.

Lightning deals have dealIsLightningDeal: true and include dealStartTime and dealEndTime in ISO 8601 format. Use these fields to display a live countdown timer or indicate urgency to your users.

Example response

{
  "data": {
    "amazonDeals": {
      "productResults": {
        "results": [
          {
            "title": "Beats Studio Pro Wireless Headphones — Personalized Spatial Audio",
            "url": "https://www.amazon.com/dp/B0C8FVFMQ6",
            "asin": "B0C8FVFMQ6",
            "price": {
              "symbol": "$",
              "value": 229.95,
              "currency": "USD",
              "display": "$229.95"
            },
            "mainImageUrl": "https://m.media-amazon.com/images/I/71y3oKTR-zL._AC_SL1500_.jpg",
            "rating": 4.3,
            "ratingsTotal": 5812,
            "recommendedRetailPrice": {
              "symbol": "$",
              "value": 349.95,
              "currency": "USD",
              "display": "$349.95"
            },
            "dealId": "d3f9a2b1-0045-4e88-bc12-f4a9e3c71200",
            "dealUrl": "https://www.amazon.com/deals/d3f9a2b1-0045-4e88-bc12-f4a9e3c71200",
            "dealPrice": {
              "symbol": "$",
              "value": 229.95,
              "currency": "USD",
              "display": "$229.95"
            },
            "dealCurrentPrice": {
              "symbol": "$",
              "value": 229.95,
              "currency": "USD",
              "display": "$229.95"
            },
            "dealListPrice": {
              "symbol": "$",
              "value": 349.95,
              "currency": "USD",
              "display": "$349.95"
            },
            "dealPercentOff": 34,
            "dealType": "BEST_DEAL",
            "dealIsLightningDeal": false,
            "dealBadge": "",
            "dealStartTime": "",
            "dealEndTime": ""
          },
          {
            "title": "Echo Dot (5th Gen) Smart Speaker with Alexa — Charcoal",
            "url": "https://www.amazon.com/dp/B09B8V1LZ3",
            "asin": "B09B8V1LZ3",
            "price": {
              "symbol": "$",
              "value": 22.99,
              "currency": "USD",
              "display": "$22.99"
            },
            "mainImageUrl": "https://m.media-amazon.com/images/I/71xoR4XBDWL._AC_SL1000_.jpg",
            "rating": 4.7,
            "ratingsTotal": 231045,
            "recommendedRetailPrice": {
              "symbol": "$",
              "value": 49.99,
              "currency": "USD",
              "display": "$49.99"
            },
            "dealId": "a1b2c3d4-5678-90ef-ab12-klmnopqrstuv",
            "dealUrl": "https://www.amazon.com/deals/a1b2c3d4-5678-90ef-ab12-klmnopqrstuv",
            "dealPrice": {
              "symbol": "$",
              "value": 22.99,
              "currency": "USD",
              "display": "$22.99"
            },
            "dealCurrentPrice": {
              "symbol": "$",
              "value": 22.99,
              "currency": "USD",
              "display": "$22.99"
            },
            "dealListPrice": {
              "symbol": "$",
              "value": 49.99,
              "currency": "USD",
              "display": "$49.99"
            },
            "dealPercentOff": 54,
            "dealType": "LIGHTNING_DEAL",
            "dealIsLightningDeal": true,
            "dealBadge": "Deal of the Day",
            "dealStartTime": "2024-11-29T08:00:00Z",
            "dealEndTime": "2024-11-29T23:59:59Z"
          }
        ],
        "pageInfo": {
          "currentPage": 1,
          "totalPages": 15,
          "totalResults": 298,
          "hasNextPage": true,
          "hasPrevPage": false
        }
      }
    }
  }
}

Error handling

If the domain value is not one of the supported marketplace codes, or if pagination parameters are invalid, the API returns a 400 error. Ensure your API-KEY is included in every request.

{
  "success": false,
  "errors": [
    {
      "code": "BAD_REQUEST",
      "message": "Invalid domain value. Supported domains: US, UK, CA, DE, FR, IT, ES, AU, IN, MX, BR, JP, PL.",
      "path": "domain"
    }
  ]
}

Status	Meaning
`400`	Missing or invalid query parameters
`401`	Missing or invalid `API-KEY` / Bearer token
`402`	Plan limit reached or payment required
`429`	Rate limit exceeded
`502`	Upstream Amazon error or bad gateway

Products

Search & Discovery

Sellers & Categories

GET /api/amazon/deals — Amazon Deals Feed

Request

Example request

Response

Example response

Error handling

​Request

​Example request

​Response

​Example response

​Error handling

Request

Example request

Response

Example response

Error handling