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

# Search Products

`GET /v1/amazon/search`

Search the Amazon catalog with filters and sorting.

## Query parameters

- `query` string, required
- `domain` string
- `page` integer
- `sort_by` 'relevance' | 'price_low_to_high' | 'price_high_to_low' | 'avg_review' | 'newest'
- `category` string
- `min_price` number
- `max_price` number
- `zip` string
- `language` string

## Response `200`

Successful search

- object
  - `query` string — The search query that was executed.
  - `domain` string — Marketplace domain that was searched.
  - `results` SearchResult[]
    - `position` integer — Position of the result on the page (1-based).
    - `asin` string — Amazon Standard Identification Number.
    - `title` string — Product title.
    - `link` string — Full URL to the product page.
    - `image` string — Primary product image URL.
    - `price` AmazonPrice
      - `value` number, nullable — Numeric price value.
      - `currency` string, nullable — ISO 4217 currency code.
      - `symbol` string, nullable — Currency symbol (e.g. $, £, €).
      - `raw` string, nullable — Price exactly as displayed on Amazon.
    - `list_price` AmazonPrice
      - `value` number, nullable — Numeric price value.
      - `currency` string, nullable — ISO 4217 currency code.
      - `symbol` string, nullable — Currency symbol (e.g. $, £, €).
      - `raw` string, nullable — Price exactly as displayed on Amazon.
    - `unit_price` string, nullable — Unit price string (e.g. "$0.50 / count").
    - `rating` number, nullable — Average star rating (0-5).
    - `ratings_total` integer, nullable — Total number of ratings.
    - `is_prime` boolean — Whether the item is Prime-eligible.
    - `is_sponsored` boolean — Whether the result is a sponsored placement.
    - `is_amazons_choice` boolean — Whether the item has the Amazon's Choice badge.
    - `is_best_seller` boolean — Whether the item has the Best Seller badge.
    - `bought_past_month` string, nullable — Purchase-volume hint (e.g. "5K+ bought in past month").
    - `coupon` string, nullable — Coupon text, if any.
    - `availability` string, nullable — Availability/stock message.
  - `pagination` Pagination — Pagination metadata.
    - `current` union
      - integer
      - string
    - `next` string, nullable
    - `total_results` integer, nullable
    - `total_pages` integer, nullable
    - `page_no` object

---

[API](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api.md) · [All operations](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scrapebadger/scrapebadger-account-api/versions/4a1ef8777baf/schema)