# Bazaarvoice Reviews API Documentation

<p>Read public retailer product reviews with rating, title, text, ISO dates, author, syndication source and full size image URLs. One credit per successful request.</p>

- **Documentation:** [https://scrappa.co/docs/bazaarvoice-api/bazaarvoice_reviews](https://scrappa.co/docs/bazaarvoice-api/bazaarvoice_reviews)
- **API group:** Bazaarvoice API
- **Endpoint:** `GET https://scrappa.co/api/bazaarvoice/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 |
| --- | --- | --- | --- |
| `product_id` | string | Yes | Product id from the retailer page, e.g. LEN101T0083. |
| `client` | string | No | Public deployment client, default lenovo-au. |
| `site` | string | No | Public deployment site, default main_site. |
| `locale` | string | No | Locale from the public deployment, default en_AU. |
| `limit` | string | No | Reviews per page, 1 to 100, default 20. |
| `offset` | string | No | Zero based offset, maximum 300000. |
| `sort` | string | No | SubmissionTime:desc, SubmissionTime:asc, Rating:desc or Rating:asc. |
| `content_locale` | string | No | Only reviews in this locale. |
| `is_syndicated` | string | No | true or false; filters by syndication. |
| `exclude_family` | string | No | true excludes reviews shared by the product family. |

## Example response

```json
{
    "data": {
        "limit": 20,
        "total": 1045,
        "offset": 0,
        "reviews": [
            {
                "id": "123",
                "text": "Fast and light.",
                "title": "Great laptop",
                "photos": [
                    "https://example.com/photo.jpg"
                ],
                "rating": 5,
                "product_id": "LEN101T0083",
                "is_syndicated": false,
                "user_nickname": "alex",
                "submission_time": "2026-01-10T09:30:00+00:00",
                "syndication_source": {
                    "name": null,
                    "content_link": null,
                    "logo_image_url": null
                }
            }
        ],
        "has_more": true,
        "statistics": {
            "total_review_count": 1045,
            "rating_distribution": [],
            "average_overall_rating": 4.6
        }
    },
    "meta": {
        "billable": true
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A filter, sort or id failed validation. No credit is charged. |
| 503 | Upstream Unavailable | The public display is temporarily unavailable. No credit is charged. |

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