Sephora

List Sephora product reviews

List reviews of a Sephora product with ratings, reviewer details, photos and review statistics.

GET/v1/sephora/product/reviews
x-api-keystringheader

API key (`sfk_...`)

Parameters
5
productIdstringrequiredquery

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

sortstringoptionalquery

Order of the reviews: `newest` (default), `oldest`, `highest_rating`, `lowest_rating` or `most_helpful`.

one of: newest, oldest, highest_rating, lowest_rating, most_helpful

ratingintegeroptionalquery

Only reviews with this many stars, 1 to 5. Default: every rating.

≥ 1 · ≤ 5

limitintegeroptionalquery

Reviews per page, 1 to 100. Default: 30.

≥ 1 · ≤ 100

cursorstringoptionalquery

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

Response fields
59

Endpoint-specific response payload.

datalookupStatus
string

`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

dataproductId
string

The product id asked for.

datatotalResults
integernullable

Reviews matching the filters, across every page.

Review statistics; null when not found.

datastatsaverageRating
numbernullable

Average stars out of 5.

datastatsreviewCount
integernullable

Reviews, every page.

datastatsrecommendedCount
integernullable

Reviewers who recommend it.

datastatsnotRecommendedCount
integernullable

Reviewers who do not.

Reviews per star rating, 5 stars first.

datastatsratingDistribution[]rating
integer

Stars, 1 to 5.

datastatsratingDistribution[]count
integer

Reviews with that many stars.

datastatsphotoCount
integernullable

Photos across every review.

datastatsfirstReviewAt
stringnullable

When the first review was posted. ISO 8601 UTC; null when not shown.

datastatslastReviewAt
stringnullable

When the latest review was posted. ISO 8601 UTC; null when not shown.

Reviews on this page.

datareviews[]id
string

Review id.

datareviews[]productId
stringnullable

Product the review was written for; a related shade or size of the same family can differ from `productId`.

datareviews[]rating
integernullable

Stars, 1 to 5.

datareviews[]title
stringnullable

Review title.

datareviews[]text
stringnullable

Review text.

datareviews[]submittedAt
stringnullable

When it was posted. ISO 8601 UTC; null when not shown.

datareviews[]authorNickname
stringnullable

Reviewer's nickname.

datareviews[]authorLocation
stringnullable

Reviewer's location.

datareviews[]isRecommended
booleannullable

Whether the reviewer recommends it.

datareviews[]isIncentivized
booleannullable

Whether the reviewer got the product free.

datareviews[]isVerifiedPurchaser
booleannullable

Whether the site marks the reviewer a verified buyer.

datareviews[]isStaff
booleannullable

Whether the reviewer is a Sephora employee.

datareviews[]isSyndicated
booleannullable

Whether the review was first posted on another site.

datareviews[]helpfulCount
integernullable

Readers who found it helpful.

datareviews[]notHelpfulCount
integernullable

Readers who did not.

datareviews[]locale
stringnullable

Language and country, e.g. `en_US`.

What the reviewer said about themselves: skin type, age range and more.

datareviews[]attributes[]id
string

Field key, e.g. `skinType`.

datareviews[]attributes[]label
stringnullable

Field label, e.g. `Skin Type`.

datareviews[]attributes[]value
stringnullable

Value label, e.g. `Combination`.

Attached photos.

datareviews[]photos[]id
stringnullable

Photo or video id.

datareviews[]photos[]url
stringnullable

Full-size URL.

datareviews[]photos[]thumbnailUrl
stringnullable

Thumbnail URL.

datareviews[]photos[]caption
stringnullable

Caption, when given.

Attached videos.

datareviews[]videos[]id
stringnullable

Photo or video id.

datareviews[]videos[]url
stringnullable

Full-size URL.

datareviews[]videos[]thumbnailUrl
stringnullable

Thumbnail URL.

datareviews[]videos[]caption
stringnullable

Caption, when given.

Replies from the brand or Sephora.

datareviews[]brandResponses[]name
stringnullable

Who responded.

datareviews[]brandResponses[]text
stringnullable

Response text.

datareviews[]brandResponses[]respondedAt
stringnullable

When they responded. ISO 8601 UTC; null when not shown.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor for the next page; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.