Sephora Categories API
Read Sephora's category tree, from Makeup and Skincare down to the narrowest subcategory, with product counts.
GET /v1/sephora/categories1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/sephora/categories returns the top-level categories in data.categories, each with id, name, url, productCount, parentId and level. Add depth=1 to depth=3 to include that many levels of subcategories; they are listed parent first, so a category's children follow it. data.totalProducts counts the whole store.
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.
Example response
A 200 response. Live responses have the same shape with current data.
Sephora Categories API FAQ
How deep does the tree go?
depth=0 returns the top level only; depth=3 includes three more levels below it. Each row's level and parentId let you rebuild the tree.
How do I get the products of a category?
Pass its id (for example cat150006) or slug to /v1/sephora/category/products.
Do the product counts change?
Yes, they follow the store's live catalogue.
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.
Other Sephora endpoints
- ProductGET /v1/sephora/product
- Product reviewsGET /v1/sephora/product/reviews
- Product questionsGET /v1/sephora/product/questions
- SearchGET /v1/sephora/search
- Search suggestionsGET /v1/sephora/search/suggestions
- CategoryGET /v1/sephora/category
- Category productsGET /v1/sephora/category/products
- BrandsGET /v1/sephora/brands