---
title: "Search Amazon Products"
method: GET
path: "/api/amazon/search"
tags: ["Amazon"]
---

# Search Amazon Products

`GET /api/amazon/search`

## Request

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

## Query parameters

- `searchTerm` string, required: The search term for fetching search results
- `domain` 'US' | 'UK' | 'CA' | 'DE' | 'FR' | 'IT' | 'ES' | 'AU' | 'IN' | 'MX' | 'BR' | 'JP' | 'PL' | 'AE' | 'SG' | 'NL' | 'SE': The domain for fetching search results data, defaults to US.
- `categoryId` string: An optional Amazon browse-node ID used to filter search results. Any valid browse-node ID for the marketplace is accepted (not limited to the Categories endpoint taxonomy, and not interchangeable with Bestsellers slugs).
- `page` number: The page number requested for product results
- `limit` number: Optionally limit the products results, typically between 20-40 results
- `minPrice` number: Minimum price filter
- `maxPrice` number: Maximum price filter
- `conditions` string: Product conditions (NEW, USED, RENEWED) - comma separated
- `sort` string: Sort order (FEATURED, MOST_RECENT, PRICE_ASCENDING, PRICE_DESCENDING, AVERAGE_CUSTOMER_REVIEW)

## Headers

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

## Response `200`

Returns Amazon product search results

- object
  - `data` object, required
    - `amazonProductSearchResults` object, required
      - `availableRefinements` object[]
        - `name` string
        - `options` object[]
          - `name` string
      - `productResults` object
        - `results` object[]
          - `title` string
          - `url` string
          - `asin` string
          - `price` AmazonProductPrice
            - `symbol` string, required
            - `value` number, required
            - `currency` string, required
            - `display` string, required
          - `mainImageUrl` string
          - `rating` number
          - `ratingsTotal` number
          - `isPrime` boolean
          - `sponsored` boolean
          - `coupon` object, nullable
            - `label` string, required
        - `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)