Sephora

Get Sephora category

Get a Sephora category with its parent categories, subcategories and product count.

GET/v1/sephora/category
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
categorystringrequiredquery

Category id (`cat150006`), category page URL (`https://www.sephora.com/shop/skincare`) or its slug (`skincare`).

min 1 chars · max 500 chars

Response fields
23

Endpoint-specific response payload.

datalookupStatus
string

Whether the item was found.

one of: found, not_found

The category; null when not found.

datacategoryid
string

Category id, e.g. `cat150006`.

datacategoryname
stringnullable

Category name.

datacategoryurl
stringnullable

Category page URL.

datacategoryproductCount
integernullable

Products in the category.

Categories above it, top level first.

datacategoryparents[]id
string

Category id.

datacategoryparents[]name
stringnullable

Category name.

Every subcategory below it, each parent before its children.

datacategorychildren[]id
string

Category id, e.g. `cat150006`.

datacategorychildren[]name
stringnullable

Category name.

datacategorychildren[]url
stringnullable

Category page URL.

datacategorychildren[]productCount
integernullable

Products in the category.

datacategorychildren[]parentId
stringnullable

Id of the category above it; null at the top level.

datacategorychildren[]level
integer

How deep it sits: 1 for a top-level category.

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/category?category=cat150006" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Sephora category.