> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/sephora/product-reviews>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/sephora/product-reviews.mdx>

---

# Sephora Product Reviews API

Page through every review of a Sephora product, newest first or by rating, with the product's review statistics.

`GET /v1/sephora/product/reviews?productId=P442563` returns `data.reviews` and `data.stats`. Each review has `id`, `rating`, `title`, `text`, `submittedAt`, `authorNickname`, `isRecommended`, `isIncentivized`, `isVerifiedPurchaser`, `isStaff`, `helpfulCount`, `notHelpfulCount`, the reviewer's self-described `attributes` (skin type, age range and more), `photos`, `videos` and `brandResponses`. `stats` carries the average rating, recommendation counts, the 5-to-1 star distribution and photo count.

Sort with `sort` (`newest`, `oldest`, `highest_rating`, `lowest_rating`, `most_helpful`), filter with `rating`, and set `limit` up to 100. Keep requesting with `page.nextCursor` while `page.hasMore` is true. An id Sephora doesn't have is `lookupStatus: not_found`; a product nobody has reviewed is `found` with no reviews.

## Request

- **Endpoint:** `GET /v1/sephora/product/reviews`
- **Credits:** 1 credit
Failed requests are free
Found, empty and not-found answers are all charged
- **Input:** by product id
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/sephora/product/reviews/get)
- **Platform page:** [/platforms/sephora](https://www.socialfetch.dev/platforms/sephora)

## FAQ

### How do I page through all reviews?

Request with limit up to 100, then pass page.nextCursor as cursor with the same productId, sort and rating until page.hasMore is false. Each page is its own request.

### Can I get only one-star or five-star reviews?

Yes. Add rating=1 to rating=5. totalResults then counts only the matching reviews, while stats describes every review of the product.

### Why can a review's productId differ from the one I asked for?

Sephora shares reviews across the shades and sizes of one product family, so a review written for a related item can appear. Its own productId shows which one.

### Does it say whether the reviewer got the product free?

Yes. isIncentivized is true when the reviewer received the product free, and isVerifiedPurchaser marks reviews the site shows as from a verified buyer.

### How many credits does a request cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
