Docs menu

Sephora API endpoint

Sephora brand directory API

Returns Sephora's full brand directory (373 brands at time of writing), sourced from the site's own A-Z brand list page. Each brand's `name` is the exact string GET /sephora/search and GET /sephora/category's repeatable `brand` filter parameter expect.

GETapiKey3 credits/requestSephorasephora.brandsResponseDoc/sephora/brands

Endpoint facts

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

Sephora Scraper API Try Sephora brand directory API in Playground Sephora API documentation

How this endpoint behaves

Returns Sephora's full brand directory (373 brands at time of writing), sourced from the site's own A-Z brand list page (sephora.com/brands-list). Use this endpoint to discover valid brand values for /sephora/search and /sephora/category without already knowing one.

Takes no parameters.

Notable response behavior:

Each brand's name is the exact string /sephora/search and /sephora/category's repeatable brand filter parameter expect -- confirmed live against those endpoints' own documented examples (Lancôme, ILIA, tarte all match this directory's name verbatim, diacritics and casing included).
slug is the path segment after sephora.com/brand/ for that brand's own storefront page (e.g. lancome). It is informational only -- no other endpoint in this API currently consumes it.
Brands are ordered the same way the site's own A-Z page is: alphabetical by name, with brands whose display name starts with a digit (e.g. 5 SENS) grouped last under a trailing "#" bucket rather than sorted numerically first.
is_new reflects Sephora's own "NEW" badge on the brand directory page at fetch time.

Live monitoring

Monitored request: GET /sephora/brands
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.93 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /sephora/brands
Items in brands: 373
Fields filled in every checked item: 3
Fields empty in some or all items: 1

Field	Filled in, of 373 checked	Values in the sample
brand_id	373
name	373	“AAVRANI” and 372 other values
slug	373
is_new	30	true in 30 of 30

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/sephora/brands" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "total_count": 373,
    "brands": [
      {
        "brand_id": "6801",
        "name": "AAVRANI",
        "slug": "aavrani"
      },
      {
        "brand_id": "5644",
        "name": "Lancôme",
        "slug": "lancome"
      },
      {
        "brand_id": "6761",
        "name": "5 SENS",
        "slug": "5-sens"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/sephora.brandsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	sephora.BrandsResponse	No
data.brands	array	No
data.brands[].brand_id	string	No	5644
data.brands[].is_new	boolean	No
data.brands[].name	string	No	Lancôme
data.brands[].slug	string	No	lancome
data.fetched_at	string	No
data.source_url	string	No
data.total_count	integer	No	373
msg	string	No	OK

Failure responses

Status	Description	Schema
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/brands" \
  -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 storefront categories 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 brand directory API

GETapiKey3 credits/requestSephorasephora.brandsResponseDoc/sephora/brands

Endpoint facts

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

Sephora Scraper API Try Sephora brand directory API in Playground Sephora API documentation

How this endpoint behaves

Takes no parameters.

Notable response behavior:

Each brand's name is the exact string /sephora/search and /sephora/category's repeatable brand filter parameter expect -- confirmed live against those endpoints' own documented examples (Lancôme, ILIA, tarte all match this directory's name verbatim, diacritics and casing included).
slug is the path segment after sephora.com/brand/ for that brand's own storefront page (e.g. lancome). It is informational only -- no other endpoint in this API currently consumes it.
Brands are ordered the same way the site's own A-Z page is: alphabetical by name, with brands whose display name starts with a digit (e.g. 5 SENS) grouped last under a trailing "#" bucket rather than sorted numerically first.
is_new reflects Sephora's own "NEW" badge on the brand directory page at fetch time.

Live monitoring

Monitored request: GET /sephora/brands
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.93 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /sephora/brands
Items in brands: 373
Fields filled in every checked item: 3
Fields empty in some or all items: 1

Field	Filled in, of 373 checked	Values in the sample
brand_id	373
name	373	“AAVRANI” and 372 other values
slug	373
is_new	30	true in 30 of 30

Request parameters

Parameter	Type	Required	Default	Description	Example
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/sephora/brands" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "total_count": 373,
    "brands": [
      {
        "brand_id": "6801",
        "name": "AAVRANI",
        "slug": "aavrani"
      },
      {
        "brand_id": "5644",
        "name": "Lancôme",
        "slug": "lancome"
      },
      {
        "brand_id": "6761",
        "name": "5 SENS",
        "slug": "5-sens"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/sephora.brandsResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	sephora.BrandsResponse	No
data.brands	array	No
data.brands[].brand_id	string	No	5644
data.brands[].is_new	boolean	No
data.brands[].name	string	No	Lancôme
data.brands[].slug	string	No	lancome
data.fetched_at	string	No
data.source_url	string	No
data.total_count	integer	No	373
msg	string	No	OK

Failure responses

Status	Description	Schema
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/brands" \
  -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 brand directory 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 brand directory 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