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/reviews1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
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.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Sephora Product Reviews API 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.
Other Sephora endpoints
- ProductGET /v1/sephora/product
- Product questionsGET /v1/sephora/product/questions
- SearchGET /v1/sephora/search
- Search suggestionsGET /v1/sephora/search/suggestions
- CategoriesGET /v1/sephora/categories
- CategoryGET /v1/sephora/category
- Category productsGET /v1/sephora/category/products
- BrandsGET /v1/sephora/brands