# Amazon Rating Summary API Documentation

<p><strong>Amazon Rating Summary API Documentation</strong> Read the average rating, the total number of ratings and the share of each star level for one ASIN. The star shares add up to 100. This endpoint gives the rating split without reviews text, which Amazon only shows to signed in customers.</p>

- **Documentation:** [https://scrappa.co/docs/amazon-api/amazon_rating_summary](https://scrappa.co/docs/amazon-api/amazon_rating_summary)
- **API group:** Amazon API
- **Endpoint:** `GET https://scrappa.co/api/amazon/rating-summary/{asin}`

## 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 |
| --- | --- | --- | --- |
| `asin` | string | Yes | Ten character product id in the path. Example: 0735211299. |
| `domain` | string | No | Amazon marketplace. Supported here: US, DE. Default: US. |

## Example response

```json
{
    "data": {
        "asin": "0735211299",
        "domain": "US",
        "histogram": {
            "1": 0,
            "2": 0,
            "3": 4,
            "4": 13,
            "5": 83
        },
        "source_url": "https://www.amazon.com/dp/0735211299",
        "total_ratings": 150366,
        "average_rating": 4.8
    },
    "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 |
| --- | --- | --- |
| 404 | Not Found | The ASIN does not exist 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)