Sephora Category API
Look up one Sephora category and see where it sits: its parents above and every subcategory below.
GET /v1/sephora/category1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/sephora/category?category=foundation-makeup returns data.category with id, name, url, productCount, parents (top level first) and children, every subcategory below it, parent first. Pass a category id such as cat150006, a category page URL or its slug. An unknown category is lookupStatus: not_found.
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 Category API FAQ
Which forms of category can I pass?
A category id such as cat150006, a page URL such as https://www.sephora.com/shop/skincare, or the slug from that URL, such as skincare.
How are subcategories ordered?
Parent first: each subcategory is followed by its own children, with parentId and level on every row.
What if the category doesn't exist?
The lookup returns lookupStatus: not_found with category: null.
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
- CategoriesGET /v1/sephora/categories
- Category productsGET /v1/sephora/category/products
- BrandsGET /v1/sephora/brands