Sephora

List Sephora brand products

List a Sephora brand's products, with prices, ratings, filters and paging.

GET/v1/sephora/brand/products
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
brandstringrequiredquery

Brand name as Sephora shows it (`rhode`, `The Ordinary`), its slug (`the-ordinary`) or brand page URL (`https://www.sephora.com/brand/the-ordinary`). Case does not matter.

min 1 chars · max 200 chars

sortstringoptionalquery

Order of the products: `relevance` (default), `bestselling`, `top_rated`, `newest`, `price_high_to_low` or `price_low_to_high`.

one of: relevance, bestselling, top_rated, newest, price_high_to_low, price_low_to_high

limitintegeroptionalquery

Products per page, 1 to 60. Default: 60.

≥ 1 · ≤ 60

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
44

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when Sephora sells no brand by that name.

one of: found, not_found

databrand
stringnullable

Brand name as Sephora writes it; null when not found.

datatotalResults
integernullable

Products matching, across every page.

Products on this page.

dataproducts[]id
string

Product id, e.g. `P442563`.

dataproducts[]name
stringnullable

Product name.

dataproducts[]brand
stringnullable

Brand name.

dataproducts[]url
stringnullable

Product page URL.

dataproducts[]skuId
stringnullable

Id of the shade or size the card shows.

dataproducts[]imageUrl
stringnullable

Product image URL.

dataproducts[]description
stringnullable

Short description the card shows.

dataproducts[]rating
numbernullable

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

dataproducts[]reviewCount
integernullable

Number of reviews.

dataproducts[]price
numbernullable

Price the shopper pays now, in `currency`.

dataproducts[]listPrice
numbernullable

Regular price before any sale, in `currency`.

dataproducts[]valuePrice
numbernullable

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

dataproducts[]currency
string

Currency code, e.g. `USD`.

dataproducts[]size
stringnullable

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

dataproducts[]variationType
stringnullable

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

dataproducts[]variationValue
stringnullable

The shown variant's shade or size.

dataproducts[]variantCount
integernullable

Number of shades or sizes.

dataproducts[]isOnSale
booleannullable

Whether it is on sale.

dataproducts[]isNew
booleannullable

Whether Sephora marks it new.

dataproducts[]isBestseller
booleannullable

Whether Sephora marks it a bestseller.

dataproducts[]isLimitedEdition
booleannullable

Whether it is a limited edition.

dataproducts[]isOnlineOnly
booleannullable

Whether it is sold online only.

dataproducts[]isSephoraExclusive
booleannullable

Whether it is a Sephora exclusive.

Filters the list offers, with product counts.

datafacets[]name
string

Filter key, e.g. `Brand` or `skinType`.

datafacets[]label
stringnullable

Filter label the site shows.

Options with their product counts; empty for a price range.

datafacets[]options[]value
string

Option value.

datafacets[]options[]label
stringnullable

Option label.

datafacets[]options[]count
integernullable

Products in the list with this option.

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/brand/products?brand=The%20Ordinary" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Sephora brand products.