Docs menu

Sephora API endpoint

Sephora storefront categories API

Returns Sephora's own live storefront category navigation (department, group, name, and slug for each), sourced from the site's own "Shop" mega-nav. Each entry's slug is directly usable as GET /sephora/category's own `slug` query parameter.

GETapiKey3 credits/requestSephorasephora.categoriesResponseDoc/sephora/categories

Endpoint facts

Method: GET
API path: /sephora/categories
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Sephora
Response schema: #/definitions/sephora.categoriesResponseDoc

Sephora Scraper API Try Sephora storefront categories API in Playground Sephora API documentation

How this endpoint behaves

Lists Sephora's own live storefront category navigation: department, group, name, and a slug usable directly as /sephora/category's own slug query parameter. Use this endpoint to discover valid category slugs without already knowing one.

Query parameters:

department (optional): filter the result to one storefront department. Allowed values: new, makeup, skincare, fragrance, hair, bath-body, mini-size, brands, gifts-value-sets, sale-offers.

Notable response behavior:

group is empty for a department's own direct child entry (e.g. Makeup's "Face", "Eye", "Brushes & Applicators" headings, each of which is itself a real, browsable category one level above the leaf items nested under it), and set to that heading's own name for every leaf item nested under it (e.g. "Foundation" carries group "Face").
The same real category can legitimately appear more than once under a different department/group pairing, or even under the same one with a different name, when Sephora's own navigation cross-lists it that way (for example "Eyelash Serums" and "Mascara" both appear under Makeup's "Eye" group and both resolve to slug mascara). This endpoint reflects that faithfully rather than deduplicating by slug.
Coverage spans every mega-nav department that resolves at least one real category, not only the five plain product departments (Makeup, Skincare, Fragrance, Hair, Bath & Body) -- curated departments like "Mini Size" and "Gifts & Value Sets" also carry their own genuine, independently browsable category slugs (e.g. gifts-under-25, shop-travel-size-makeup) and are included. "50% Off Deals" and "Gift Cards" are present in Sephora's own mega-nav but resolve zero category slugs each, so they are excluded from both the department enum and the response.

Live monitoring

Monitored request: GET /sephora/categories?department=makeup
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.04 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /sephora/categories?department=makeup
Items in categories: 67
Fields filled in every checked item: 3
Fields empty in some or all items: 1

Field	Filled in, of 67 checked	Values in the sample
department	67	makeup in all 67
name	67	“All Makeup” and 64 other values
slug	67
group	50	Face (11), Eye (11), Lip (10) and 3 more

Request parameters

Parameter	Type	Required	Default	Description	Example
department	string	No		Filter to one storefront department Allowed values: new, makeup, skincare, fragrance, hair, bath-body, mini-size, brands, gifts-value-sets, sale-offers.	makeup
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/sephora/categories?department=new" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.sephora.com/",
    "fetched_at": "2026-09-15T12:00:00Z",
    "categories": [
      {
        "department": "makeup",
        "name": "All Makeup",
        "slug": "makeup-cosmetics"
      },
      {
        "department": "makeup",
        "name": "Eye",
        "slug": "eye-makeup"
      },
      {
        "department": "makeup",
        "group": "Eye",
        "name": "Mascara",
        "slug": "mascara"
      },
      {
        "department": "gifts-value-sets",
        "name": "Gifts Under $25",
        "slug": "gifts-under-25"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/sephora.categoriesResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	sephora.CategoriesResponse	No
data.categories	array	No
data.categories[].department	string	No	makeup
data.categories[].group	string	No	Eye
data.categories[].name	string	No	Mascara
data.categories[].slug	string	No	mascara
data.fetched_at	string	No
data.source_url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/sephora/categories?department=new" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Sephora endpoint docs Sephora Scraper API Sephora brand directory API documentation Sephora category browse API documentation Sephora product detail API documentation Sephora Product Q&A API documentation Sephora product reviews API documentation Sephora product search API documentation

Open in Playground Back to group

Docs menu

Sephora API endpoint

Sephora storefront categories API

GETapiKey3 credits/requestSephorasephora.categoriesResponseDoc/sephora/categories

Endpoint facts

Method: GET
API path: /sephora/categories
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Sephora
Response schema: #/definitions/sephora.categoriesResponseDoc

Sephora Scraper API Try Sephora storefront categories API in Playground Sephora API documentation

How this endpoint behaves

Query parameters:

department (optional): filter the result to one storefront department. Allowed values: new, makeup, skincare, fragrance, hair, bath-body, mini-size, brands, gifts-value-sets, sale-offers.

Notable response behavior:

group is empty for a department's own direct child entry (e.g. Makeup's "Face", "Eye", "Brushes & Applicators" headings, each of which is itself a real, browsable category one level above the leaf items nested under it), and set to that heading's own name for every leaf item nested under it (e.g. "Foundation" carries group "Face").
The same real category can legitimately appear more than once under a different department/group pairing, or even under the same one with a different name, when Sephora's own navigation cross-lists it that way (for example "Eyelash Serums" and "Mascara" both appear under Makeup's "Eye" group and both resolve to slug mascara). This endpoint reflects that faithfully rather than deduplicating by slug.
Coverage spans every mega-nav department that resolves at least one real category, not only the five plain product departments (Makeup, Skincare, Fragrance, Hair, Bath & Body) -- curated departments like "Mini Size" and "Gifts & Value Sets" also carry their own genuine, independently browsable category slugs (e.g. gifts-under-25, shop-travel-size-makeup) and are included. "50% Off Deals" and "Gift Cards" are present in Sephora's own mega-nav but resolve zero category slugs each, so they are excluded from both the department enum and the response.

Live monitoring

Monitored request: GET /sephora/categories?department=makeup
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.04 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /sephora/categories?department=makeup
Items in categories: 67
Fields filled in every checked item: 3
Fields empty in some or all items: 1

Field	Filled in, of 67 checked	Values in the sample
department	67	makeup in all 67
name	67	“All Makeup” and 64 other values
slug	67
group	50	Face (11), Eye (11), Lip (10) and 3 more

Request parameters

Parameter	Type	Required	Default	Description	Example
department	string	No		Filter to one storefront department Allowed values: new, makeup, skincare, fragrance, hair, bath-body, mini-size, brands, gifts-value-sets, sale-offers.	makeup
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/sephora/categories?department=new" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.sephora.com/",
    "fetched_at": "2026-09-15T12:00:00Z",
    "categories": [
      {
        "department": "makeup",
        "name": "All Makeup",
        "slug": "makeup-cosmetics"
      },
      {
        "department": "makeup",
        "name": "Eye",
        "slug": "eye-makeup"
      },
      {
        "department": "makeup",
        "group": "Eye",
        "name": "Mascara",
        "slug": "mascara"
      },
      {
        "department": "gifts-value-sets",
        "name": "Gifts Under $25",
        "slug": "gifts-under-25"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/sephora.categoriesResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	sephora.CategoriesResponse	No
data.categories	array	No
data.categories[].department	string	No	makeup
data.categories[].group	string	No	Eye
data.categories[].name	string	No	Mascara
data.categories[].slug	string	No	mascara
data.fetched_at	string	No
data.source_url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/sephora/categories?department=new" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Sephora storefront categories API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Sephora storefront categories API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related