# Douglas Reviews API Documentation

<p><strong>Douglas Reviews API</strong> returns the first page of public reviews for a base product id. Each review has a numeric rating, title, text, user nickname and an ISO 8601 submission time. The upstream exposes only this first page, so a page value above 1 is rejected with 422. The total is null when the source does not publish one.</p><p><strong>Cost:</strong> 1 credit per request. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/douglas-api/douglas_reviews](https://scrappa.co/docs/douglas-api/douglas_reviews)
- **API group:** Douglas API
- **Endpoint:** `GET https://scrappa.co/api/douglas/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 |
| --- | --- | --- | --- |
| `id` | string | Yes | Base product id from search or product, for example 5000005003. |

## Example response

```json
{
    "data": {
        "reviews": [
            {
                "id": "r1",
                "text": "Long lasting.",
                "title": "Great scent",
                "rating": 5,
                "product_id": "5000005003",
                "recommended": true,
                "user_nickname": "skinlover",
                "submission_time": "2026-10-01T10:00:00+00:00"
            }
        ],
        "pagination": {
            "page": 1,
            "per_page": 10,
            "has_next_page": false,
            "total_results": null,
            "next_page_reachable": false
        }
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "reviews"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Error | The id is invalid or a page above 1 was sent. Not billed. |
|  | Error | Douglas could not be reached. 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)
