List Sephora product reviews
List reviews of a Sephora product with ratings, reviewer details, photos and review statistics.
Headers
Get your API keyAPI key (`sfk_...`)
Sephora product id (`P442563`) or product page URL (`https://www.sephora.com/product/aha-30-bha-2-peeling-solution-P442563`).
min 1 chars · max 500 chars
Order of the reviews: `newest` (default), `oldest`, `highest_rating`, `lowest_rating` or `most_helpful`.
one of: newest, oldest, highest_rating, lowest_rating, most_helpful
Only reviews with this many stars, 1 to 5. Default: every rating.
≥ 1 · ≤ 5
Reviews per page, 1 to 100. Default: 30.
≥ 1 · ≤ 100
Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters.
min 1 chars · max 1024 chars
Endpoint-specific response payload.
`not_found` when Sephora has no product with this id; a product with no reviews is `found` with an empty list.
one of: found, not_found
The product id asked for.
Reviews matching the filters, across every page.
Review statistics; null when not found.
Average stars out of 5.
Reviews, every page.
Reviewers who recommend it.
Reviewers who do not.
Reviews per star rating, 5 stars first.
Stars, 1 to 5.
Reviews with that many stars.
Photos across every review.
When the first review was posted. ISO 8601 UTC; null when not shown.
When the latest review was posted. ISO 8601 UTC; null when not shown.
Reviews on this page.
Review id.
Product the review was written for; a related shade or size of the same family can differ from `productId`.
Stars, 1 to 5.
Review title.
Review text.
When it was posted. ISO 8601 UTC; null when not shown.
Reviewer's nickname.
Reviewer's location.
Whether the reviewer recommends it.
Whether the reviewer got the product free.
Whether the site marks the reviewer a verified buyer.
Whether the reviewer is a Sephora employee.
Whether the review was first posted on another site.
Readers who found it helpful.
Readers who did not.
Language and country, e.g. `en_US`.
What the reviewer said about themselves: skin type, age range and more.
Field key, e.g. `skinType`.
Field label, e.g. `Skin Type`.
Value label, e.g. `Combination`.
Attached photos.
Photo or video id.
Full-size URL.
Thumbnail URL.
Caption, when given.
Attached videos.
Photo or video id.
Full-size URL.
Thumbnail URL.
Caption, when given.
Replies from the brand or Sephora.
Who responded.
Response text.
When they responded. ISO 8601 UTC; null when not shown.
Pagination state for the current page.
Whether another page is available.
Cursor for the next page; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/sephora/product/reviews?productId=P442563" \
-H "x-api-key: YOUR_API_KEY"Responses
Sephora product reviews.