---
title: "Get Amazon Deals"
method: GET
path: "/api/amazon/deals"
tags: ["Amazon"]
---

# Get Amazon Deals

`GET /api/amazon/deals`

## Request

- Base URL: `https://rest.canopyapi.co`
- URL: `https://rest.canopyapi.co/api/amazon/deals`
- Auth: API key in header `API-KEY`

Retrieve current deals from Amazon. Returns a paginated list of products currently on deal, including deal-specific information like discount percentages and deal badges.

## Query parameters

- `domain` 'US' | 'UK' | 'CA' | 'DE' | 'FR' | 'IT' | 'ES' | 'AU' | 'IN' | 'MX' | 'BR' | 'JP' | 'PL' | 'AE' | 'SG' | 'NL' | 'SE': The domain for fetching deals data, defaults to US.
- `page` number: The page number requested for product results
- `limit` number: Optionally limit the products results. Typically between 20-40 results will be available per page if no limit is applied.
- `categoryIds` string: Optional comma-separated list of category IDs to filter deals (e.g. "3760911,172282"). Category IDs can be discovered via the Categories API or from the categories array in deals responses.

## Headers

- `API-KEY` string, required: API key for authentication

## Response `200`

Returns Amazon deals with product information

- object
  - `data` object, required
    - `amazonDeals` object, required
      - `productResults` object
        - `results` object[]
          - `title` string
          - `url` string
          - `asin` string
          - `price` AmazonProductPrice
            - `symbol` string, required
            - `value` number, required
            - `currency` string, required
            - `display` string, required
          - `recommendedRetailPrice` AmazonProductPrice
            - `symbol` string, required
            - `value` number, required
            - `currency` string, required
            - `display` string, required
          - `mainImageUrl` string
          - `dealId` string
          - `dealUrl` string
          - `dealPrice` AmazonProductPrice
            - `symbol` string, required
            - `value` number, required
            - `currency` string, required
            - `display` string, required
          - `dealCurrentPrice` AmazonProductPrice
            - `symbol` string, required
            - `value` number, required
            - `currency` string, required
            - `display` string, required
          - `dealListPrice` AmazonProductPrice
            - `symbol` string, required
            - `value` number, required
            - `currency` string, required
            - `display` string, required
          - `dealPercentOff` number
          - `dealType` string
          - `dealIsLightningDeal` boolean
          - `dealBadge` string
          - `dealStartTime` string
          - `dealEndTime` string
        - `pageInfo` AmazonPageInfo
          - `currentPage` number
          - `totalPages` number
          - `hasNextPage` boolean
          - `hasPrevPage` boolean
          - `totalResults` number

## Other responses

- `400`: Input Validation Error
- `401`: Unauthorized
- `500`: Internal Server Error - request failed

---

[API](https://skmtc.dev/canopyapi/apis/canopy-api-rest-endpoints.md) · [All operations](https://skmtc.dev/canopyapi/apis/canopy-api-rest-endpoints/llms.txt) · [OpenAPI document](https://skmtc.dev/canopyapi/apis/canopy-api-rest-endpoints/revisions/dc3281f521e7?raw)