Sephora

List Sephora categories

List Sephora's top-level product categories and their subcategories, with product counts.

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

API key (`sfk_...`)

Parameters
1
depthintegerquery

Levels of subcategories to include under each top-level category, 0 to 3. Default: 0.

≥ 0 · ≤ 3

Response fields
16

Endpoint-specific response payload.

datalookupStatus
string

Always `found`.

one of: found, not_found

datatotalProducts
integernullable

Products across the whole store.

Top-level categories and their subcategories to `depth`, each parent before its children.

datacategories[]id
string

Category id, e.g. `cat150006`.

datacategories[]name
stringnullable

Category name.

datacategories[]url
stringnullable

Category page URL.

datacategories[]productCount
integernullable

Products in the category.

datacategories[]parentId
stringnullable

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

datacategories[]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/categories?depth=1" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Sephora categories.