Sephora hub

Sephora Category API

Look up one Sephora category and see where it sits: its parents above and every subcategory below.

GET /v1/sephora/category

1 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.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

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.