# Sephora Reviews API (https://www.socialcrawl.dev/platforms/sephora/reviews)

> Returns written customer reviews for a Sephora product, 10 per page by default, each with the full review text, star rating, title, reviewer nickname, submission date, and helpful-vote count. The review total is exact. Pass the returned cursor back until has_more is false. Optional sort_by: most_helpful, highest_rating, lowest_rating, oldest, newest. Optional rating keeps only that star value.

TL;DR: `GET /v1/sephora/reviews` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `product_id` | no | Sephora product id, the P-number at the end of a product URL: sephora.com/product/the-ordinary-deciem-natural-moisturizing-factors-ha-P427414 is product id P427414. Product ids also come back on every row of GET /v1/sephora/search and GET /v1/sephora/category. |
| `url` | no | Full Sephora product URL, for example https://www.sephora.com/product/the-ordinary-deciem-natural-moisturizing-factors-ha-P427414. The product id is extracted from the path. |
| `page` | no | Page number, starting at 1. Prefer the universal cursor parameter. |
| `limit` | no | Reviews per page, 1 to 100. Default 10. |
| `sort_by` | no | Review ordering: most_helpful, highest_rating, lowest_rating, oldest, newest. (most_helpful \| highest_rating \| lowest_rating \| oldest \| newest) |
| `rating` | no | Keep only reviews with this star value, 1 to 5. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/sephora/reviews" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

See the full Sephora API: https://www.socialcrawl.dev/platforms/sephora

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing