# Sephora Reviews API Documentation

<p><strong>Sephora Reviews API</strong> returns public reviews for the product id from a search answer. Each review has numeric rating, title, text, ISO 8601 submission time, user nickname, recommended flag and pros and cons. Results are sorted by newest and paginated 20 per page.</p><p><strong>Cost:</strong> 1 credit per request. Failed requests are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/sephora-api/sephora_reviews](https://scrappa.co/docs/sephora-api/sephora_reviews)
- **API group:** Sephora API
- **Endpoint:** `GET https://scrappa.co/api/sephora/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 | The product id from a search answer, for example P515494. |
| `page` | integer | No | One-based page number, 1 to 50 (default 1). |

## Example response

```json
{
    "data": {
        "reviews": [
            {
                "id": "123",
                "cons": [],
                "pros": [],
                "text": "Absorbs quickly.",
                "title": "Great lotion",
                "rating": 5,
                "product_id": "P515494",
                "recommended": true,
                "user_nickname": "skinlover",
                "submission_time": "2026-10-01T10:00:00+00:00"
            }
        ],
        "pagination": {
            "page": 1,
            "per_page": 20,
            "has_next_page": true,
            "total_results": 8123
        }
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "reviews"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | Error | Send a valid product id. Not billed. |
|  | Error | Sephora 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)
