> Documentation index: https://docs.scrapier.io/llms.txt
> Auth: header `X-API-Key: <key>` · Base: https://api.scrapier.io/api/v2 · Synchronous; paginate with `cursor` ← `data.next_cursor`.

# Amazon API

Search results, product pages, best sellers, daily deals, reviews, sellers and influencer shops from Amazon, as structured JSON.

9 endpoints · 1–3 credits / successful call · All Amazon endpoints in one file: https://docs.scrapier.io/llms-amazon.txt

## Quickstart

### Search Amazon for a keyword

Returns one page of products. Pass `data.next_cursor` back as `cursor` for the next page.

```bash
curl -G "https://api.scrapier.io/api/v2/amazon-search/" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "query=Playstation" \
  --max-time 210
```

### Get the best sellers in a category

Send a Best Sellers category URL and get ranked products back.

```bash
curl -G "https://api.scrapier.io/api/v2/amazon-bestsellers/" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "url=https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics/" \
  --max-time 210
```

### Read a product's reviews

One call with an ASIN or product URL. No pagination.

```bash
curl -G "https://api.scrapier.io/api/v2/amazon-review/" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "asins=B0B2RM68G2" \
  --max-time 210
```

## Endpoints

| Endpoint | Path | Pagination | Credits | Needs cookie |
|---|---|---|---|---|
| [Amazon ASIN Lookup](https://docs.scrapier.io/api-reference/amazon/amazon-asin-lookup.md) | `/amazon-asin-lookup/` | single | 2 | no |
| [Amazon Best Sellers](https://docs.scrapier.io/api-reference/amazon/amazon-bestsellers.md) | `/amazon-bestsellers/` | cursor | 1 | no |
| [Amazon Keyword Suggestions](https://docs.scrapier.io/api-reference/amazon/amazon-keyword-suggestion.md) | `/amazon-keyword-suggestion/` | single | 1 | no |
| [Amazon Products](https://docs.scrapier.io/api-reference/amazon/amazon-product.md) | `/amazon-product/` | cursor | 1 | no |
| [Amazon Product Reviews](https://docs.scrapier.io/api-reference/amazon/amazon-review.md) | `/amazon-review/` | single | 2 | no |
| [Amazon Search](https://docs.scrapier.io/api-reference/amazon/amazon-search.md) | `/amazon-search/` | cursor | 1 | no |
| [Amazon Sellers](https://docs.scrapier.io/api-reference/amazon/amazon-seller-scraper.md) | `/amazon-seller-scraper/` | cursor | 3 | no |
| [Amazon Influencer Shop](https://docs.scrapier.io/api-reference/amazon/amazon-shop.md) | `/amazon-shop/` | cursor | 1 | no |
| [Amazon Today's Deals](https://docs.scrapier.io/api-reference/amazon/amazon-todays-deals.md) | `/amazon-todays-deals/` | cursor | 1 | no |

## Choosing an endpoint

- Keyword search with sort order and marketplace → amazon-search. Keyword, search URL or a single product URL in one endpoint → amazon-product.
- Ranked top sellers of a category → amazon-bestsellers. Today's discounted items, no input needed → amazon-todays-deals.
- Reviews of one product → amazon-review. Search-box autocomplete ideas for a keyword → amazon-keyword-suggestion.
- Who sells a product, with the seller's business details → amazon-seller-scraper. An influencer's storefront and its lists → amazon-shop.

## Notes

- Plural-looking params such as `queries`, `urls` and `asins` take one value per call.
- Each call costs the endpoint's credits (shown on its page) per successful call, however many products the page holds.
