Sephora

Get Sephora product

Get a Sephora product with every shade and size, prices, stock flags, ingredients and ratings.

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

API key (`sfk_...`)

Parameters
2
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

skuIdstringoptionalquery

Shade or size to select (`2210607`); `selectedSkuId` echoes it. Default: the one the product page opens on.

pattern: ^\d{4,12}$

Response fields
87

Endpoint-specific response payload.

datalookupStatus
string

Whether the item was found.

one of: found, not_found

The product; null when not found.

dataproductid
string

Product id, e.g. `P442563`.

dataproductname
string

Product name.

dataproducturl
string

Product page URL.

The product's brand.

dataproductbrandid
stringnullable

Brand id; null when not shown.

dataproductbrandname
string

Brand name.

dataproductbrandurl
stringnullable

Brand page URL; null when not shown.

The product's own category.

dataproductcategoryid
string

Category id, e.g. `cat150006`.

dataproductcategoryname
stringnullable

Category name.

dataproductcategoryurl
stringnullable

Category page URL; null when not shown.

Category path from the top level down to `category`.

dataproductbreadcrumbs[]id
string

Category id, e.g. `cat150006`.

dataproductbreadcrumbs[]name
stringnullable

Category name.

dataproductbreadcrumbs[]url
stringnullable

Category page URL; null when not shown.

dataproductrating
numbernullable

Average star rating out of 5; null with no reviews.

dataproductreviewCount
integernullable

Number of reviews.

dataproductlovesCount
integernullable

How many shoppers saved it to their loves.

dataproductdescription
stringnullable

Short description, as plain text.

dataproductlongDescription
stringnullable

Full description, as plain text.

dataproductsuggestedUsage
stringnullable

How to use it, as plain text.

dataproductcurrency
string

Currency of every price, e.g. `USD`.

dataproductvariationType
stringnullable

What the skus differ by: `Color`, `Size` or `None`.

dataproductselectedSkuId
stringnullable

Sku the page opened on (the `skuId` you asked for).

Every shade and size, in the site's order.

dataproductskus[]id
string

Sku id, e.g. `2210607`.

dataproductskus[]url
stringnullable

Product page URL for this sku.

dataproductskus[]size
stringnullable

Size, e.g. `1 oz/ 30 mL`.

dataproductskus[]variationValue
stringnullable

Shade or size name the selector shows.

dataproductskus[]variationDescription
stringnullable

Longer shade description, when there is one.

dataproductskus[]price
numbernullable

Price the shopper pays now, in `currency`.

dataproductskus[]listPrice
numbernullable

Regular price before any sale, in `currency`.

dataproductskus[]salePrice
numbernullable

Sale price; null when it is not on sale.

dataproductskus[]valuePrice
numbernullable

Stated value of a set or kit; null when none is shown.

dataproductskus[]priceText
stringnullable

Price as the site writes it, e.g. `$9.50`.

dataproductskus[]imageUrl
stringnullable

Main image URL.

Every image of the sku, main image first.

dataproductskus[]imageUrls[]
stringoptional
dataproductskus[]isOutOfStock
booleannullable

Whether it is sold out.

dataproductskus[]isOnlyFewLeft
booleannullable

Whether the site says only a few are left.

dataproductskus[]isNew
booleannullable

Whether Sephora marks it new.

dataproductskus[]isLimitedEdition
booleannullable

Whether it is a limited edition.

dataproductskus[]isOnlineOnly
booleannullable

Whether it is sold online only.

dataproductskus[]isSephoraExclusive
booleannullable

Whether it is a Sephora exclusive.

dataproductskus[]isAppExclusive
booleannullable

Whether it is sold only in the app.

dataproductskus[]isMembersOnly
booleannullable

Whether only loyalty members can buy it.

dataproductskus[]isReturnable
booleannullable

Whether it can be returned.

dataproductskus[]isPickupEligible
booleannullable

Whether it can be picked up in a store.

dataproductskus[]isSameDayEligible
booleannullable

Whether it can be delivered the same day.

dataproductskus[]maxPurchaseQuantity
integernullable

Most units one order may hold.

Product attributes for this sku: skin type, finish, and so on.

dataproductskus[]attributes[]name
string

Attribute key, e.g. `skinType`.

dataproductskus[]attributes[]label
string

The site's label for it, e.g. `Skin Type`.

Its values as the site labels them, e.g. `Normal`.

dataproductskus[]attributes[]values[]
stringoptional

The same values as the site's codes, in the same order, e.g. `normalSk`.

dataproductskus[]attributes[]codes[]
stringoptional
dataproductskus[]ingredients
stringnullable

Ingredient list, as plain text.

dataproductskus[]disclosures
stringnullable

Warnings and disclosures, as plain text.

Key ingredients and claims the page highlights.

dataproducthighlights[]name
string

Highlight, e.g. `Salicylic Acid`.

dataproducthighlights[]description
stringnullable

What it means for this product.

Product videos.

dataproductvideos[]id
stringnullable

Video id.

dataproductvideos[]title
stringnullable

Video title.

dataproductvideos[]url
stringnullable

Video page URL.

dataproductvideos[]imageUrl
stringnullable

Still image URL.

The page's review summary; null when it has none.

dataproductreviewSummarytext
stringnullable

Summary of what reviewers say.

Themes reviewers praise.

dataproductreviewSummarypros[]name
string

Theme reviewers praise.

dataproductreviewSummarypros[]count
integernullable

Mentions.

Themes reviewers criticise.

dataproductreviewSummarycons[]name
string

Theme reviewers criticise.

dataproductreviewSummarycons[]count
integernullable

Mentions.

Related shopping pages the product page links.

dataproductrelatedSearches[]name
string

Link text.

dataproductrelatedSearches[]url
string

Link URL.

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?productId=P442563" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Sephora product.