Sephora hub

Sephora Product Search API

Search Sephora's catalogue by keyword and get priced, rated products with the filters the store offers.

GET /v1/sephora/search

1 credit Failed requests are free Found, empty and not-found answers are all charged

About this endpoint

GET /v1/sephora/search?query=vitamin%20c%20serum returns data.products, data.totalResults, data.facets and data.relatedSearches. Each product has id, name, brand, url, skuId, imageUrl, rating, reviewCount, price, listPrice, valuePrice, size, variationType, variantCount and flags such as isOnSale, isNew and isBestseller. facets lists the store's filters (brand, skin type, price, ingredients and more) with product counts.

Order with sort (relevance, bestselling, top_rated, newest, price_high_to_low, price_low_to_high), set limit up to 60 and follow page.nextCursor. The store returns its closest products even for words it doesn't know, so check totalResults and the products themselves.

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 Search API FAQ

How many products does one request return?

Up to 60, set with limit. Follow page.nextCursor while page.hasMore is true for the rest; each page is its own request.

Can I sort by price or bestselling?

Yes. sort accepts relevance, bestselling, top_rated, newest, price_high_to_low and price_low_to_high.

What are facets?

The filters the store shows next to the results, such as Brand, skinType or Price, with how many matching products each option has. Use them to see a search's spread by brand or concern.

Is a search with no exact match empty?

Not always. The store also returns related products for words it doesn't recognise, the same way its own search box does.

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.