Sephora hub

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

1 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.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

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.