# Reviews.io Stats API Documentation

<p>Read the public aggregate rating groups for one Reviews.io store. Returns company, product and third-party groups with a numeric rating and an integer review count. The upstream blocks are company_review_stats, product_review_stats and third_party_review_stats; count comes from total_reviews. A zero rating means no rating and is returned as null. Choose country=us or country=uk. Failed requests are not billed. Not affiliated with Reviews.io.</p>

- **Documentation:** [https://scrappa.co/docs/reviews-io-api/reviews_io_stats](https://scrappa.co/docs/reviews-io-api/reviews_io_stats)
- **API group:** Reviews.io API
- **Endpoint:** `GET https://scrappa.co/api/reviews-io/stats`

## 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 |
| --- | --- | --- | --- |
| `store` | string | Yes | Store slug from the Reviews.io merchants endpoint. |
| `country` | string | No | us or uk, default us. |

## Example response

```json
{
    "data": {
        "store": "example-store",
        "company": {
            "rating": 4.4,
            "review_count": 800
        },
        "country": "uk",
        "product": {
            "rating": null,
            "review_count": null
        },
        "third_party": {
            "rating": null,
            "review_count": null
        }
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "reviews-io.stats"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 503 | Upstream Unavailable | Reviews.io is temporarily unavailable. Not billed. |

## 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)
