# Amazon Best Sellers API Documentation

<p><strong>Amazon Best Sellers API Documentation</strong> Read the ranked best sellers list of a category: rank, ASIN, title, price, rating, rating count, image and product link. Fifty entries per page. Pages 1 and 2 give ranks 1 to 100. An unknown category answers 404.</p>

- **Documentation:** [https://scrappa.co/docs/amazon-api/amazon_best_sellers](https://scrappa.co/docs/amazon-api/amazon_best_sellers)
- **API group:** Amazon API
- **Endpoint:** `GET https://scrappa.co/api/amazon/best-sellers/{category}`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `category` | string | Yes | Category slug, optionally with a node id. Examples: electronics or electronics/281407. Take values from the categories endpoint. |
| `domain` | string | No | Amazon marketplace. Supported here: US, DE, UK. Default: US. |
| `page` | integer | No | List page, 1 or 2. Default: 1. |

## Example response

```json
{
    "data": {
        "kind": "best-sellers",
        "page": 1,
        "items": [
            {
                "url": "https://www.amazon.com/dp/B08JHCVHTY",
                "asin": "B08JHCVHTY",
                "rank": 1,
                "image": "https://images-na.ssl-images-amazon.com/images/I/31YHGbJsldL._AC_UL300_SR300,200_.png",
                "price": {
                    "amount": 11.99,
                    "display": "$11.99",
                    "currency": "USD"
                },
                "title": "blink plus plan with monthly auto-renewal",
                "rating": 4.4,
                "ratings_count": 281628
            }
        ],
        "title": "Amazon Best Sellers: Best Electronics",
        "domain": "US",
        "category": "electronics",
        "source_url": "https://www.amazon.com/gp/bestsellers/electronics",
        "items_count": 50,
        "has_next_page": true
    },
    "meta": {
        "cached": false,
        "domain": "US",
        "currency": "USD",
        "language": "en_US",
        "timestamp": "2026-10-31T22:00:00.000000Z",
        "response_time_ms": 4200
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query or path parameter is missing or invalid. This response is not billable. |
| 404 | Not Found | The category does not exist. This response is not billable. |
| 503 | Service Unavailable | Amazon could not be reached after several tries. This response is not billable. Retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
