---
title: "Scrape Amazon search listings"
method: POST
path: "/marketplace/amazon-search"
tags: ["Plugins"]
---

# Scrape Amazon search listings

`POST /marketplace/amazon-search`

## Request

- Base URL: `https://api.scrapeunblocker.com`
- URL: `https://api.scrapeunblocker.com/marketplace/amazon-search`
- Auth: API key in header `x-scrapeunblocker-key`

Searches any regional Amazon marketplace for `keyword` and returns the result cards as JSON: `asin`, `title`, `price` + `currency`, `listPrice`, `rating`, `reviewCount`, a clean product `url`, `image`, and the `sponsored` / `prime` flags. Filter with `min_price` / `max_price`, order with `sort` (featured, price_asc, price_desc, avg_review, newest), and page with `page`.

Fetch each result's full detail (all fields above plus features and images) through `POST /marketplace/amazon-product`. Some cards show no price on the search page (Amazon defers it, or the item has buying options); those return `price: null` and are kept in the list rather than dropped. `proxy_country` defaults to the marketplace's home country so prices are in the expected currency.

## Query parameters

- `keyword` string, required: Search phrase, e.g. 'wireless headphones' or a brand + model.
- `marketplace` string: Regional Amazon site to search. Prices and currency differ per marketplace. One of: amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.it, amazon.es, amazon.nl, amazon.se, amazon.pl, amazon.com.be, amazon.com.tr, amazon.ca, amazon.com.mx, amazon.com.br, amazon.co.jp, amazon.in, amazon.ae, amazon.sa, amazon.sg, amazon.com.au.
- `page` integer: 1-based page number.
- `sort` string: Result order: featured, price_asc, price_desc, avg_review, newest. Default 'featured'.
- `min_price` number, nullable: Lowest price to include, in the marketplace's currency.
- `max_price` number, nullable: Highest price to include, in the marketplace's currency.
- `proxy_country` string, nullable: Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE'). Defaults to the marketplace's home country so prices come back in the expected currency.

## Response `200`

JSON with a `results` array of product cards.

- unknown

## Other responses

- `400`: Invalid search parameters.
- `422`: Validation Error
- `502`: Blocked by Amazon, no results page returned, or the call did not finish in time.

---

[API](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api.md) · [All operations](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/revisions/c02f1254cc47?raw)