# Amazon Seller Reviews API Documentation

<p><strong>Amazon Seller Reviews API Documentation</strong> Read the feedback customers left for a seller: rater name, star rating, text, date, whether Amazon fulfilled the order and the seller response. Filter by one star rating (1 to 5) and by period (30d, 90d, 365d or lifetime). Five entries per page. Use has_next_page to page. Rater profile links and avatars are not returned.</p>

- **Documentation:** [https://scrappa.co/docs/amazon-api/amazon_seller_reviews](https://scrappa.co/docs/amazon-api/amazon_seller_reviews)
- **API group:** Amazon API
- **Endpoint:** `GET https://scrappa.co/api/amazon/seller/{sellerId}/reviews`

## 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 |
| --- | --- | --- | --- |
| `sellerId` | string | Yes | Seller id in the path. |
| `domain` | string | No | Amazon marketplace. Supported here: US, DE. Default: US. |
| `page` | integer | No | Feedback page, 1 and up. Default: 1. |
| `rating` | integer | No | Only feedback with this star rating, 1 to 5. |
| `period` | string | No | 30d, 90d, 365d or lifetime. Default: 365d. |

## Example response

```json
{
    "data": {
        "page": 1,
        "domain": "US",
        "period": "lifetime",
        "rating": 5,
        "reviews": [
            {
                "date": "October 8, 2026",
                "text": "Book arrived quickly and in described condition.",
                "rater": "T. Karls",
                "rating": 5,
                "date_iso": "2026-10-08",
                "seller_response": null,
                "fulfilled_by_amazon": false,
                "has_seller_response": false
            }
        ],
        "seller_id": "A1N6INQ4SRJFXQ",
        "source_url": "https://www.amazon.com/sp?seller=A1N6INQ4SRJFXQ",
        "has_next_page": true,
        "reviews_count": 5
    },
    "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 seller id is unknown on this marketplace. 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)