Docs menu

Sephora API endpoint

Sephora product detail API

Returns one Sephora product's full detail (every color/shade variant with its own price and availability, rating, review count, and a sample of recent reviews). `product_id` is the full product-page slug, e.g. `lip-sleeping-mask-P420652` -- copy it from the path segment after sephora.com/product/ on any product page; unlike some other retailers, an arbitrary or partial slug does not resolve.

GETapiKey3 credits/requestSephorasephora.productResponseDoc/sephora/product

Endpoint facts

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

Sephora Scraper API Try Sephora product detail API in Playground Sephora API documentation

How this endpoint behaves

Query parameters:

product_id: required. The full Sephora product-page slug, e.g. lip-sleeping-mask-P420652 -- copy it from the path segment after sephora.com/product/ on any product page. Unlike some other retailers, an arbitrary or partial slug does not resolve to the real product; the full slug is required.

Notable response behavior:

variants lists every purchasable color/shade of the product, each with its own sku, price, currency_code, and availability (InStock or OutOfStock).
review_sample is a small sample of recent reviews embedded on the product page itself, not the full review set -- there is currently no separate paginated reviews endpoint for this family.
An unresolved or malformed product_id returns 404.

Live monitoring

Monitored request: GET /sephora/product?product_id=lip-sleeping-mask-P420652
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.36 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /sephora/product?product_id=lip-sleeping-mask-P420652
Items in review_sample: 10
Fields filled in every checked item: 5
Fields empty in some or all items: 1

Field	Filled in, of 10 checked	Values in the sample
id	10
author	10
title	6	“not good” and 5 other values
body	10	median 163 characters
rating	10	1 to 5, median 4
date_published	10	2021-01-04 to 2026-10-11

Request parameters

Parameter	Type	Required	Default	Description	Example
product_id	string	Yes		Full Sephora product-page slug	lip-sleeping-mask-P420652
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/sephora/product?product_id=lip-sleeping-mask-P420652" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "product_group_id": "P420652",
    "name": "Lip Sleeping Mask – Intense Hydration Lip Treatment with Vitamin C",
    "description": "Shop LANEIGE's Lip Sleeping Mask at Sephora.",
    "brand": "LANEIGE",
    "category": "lip-balm-lip-care",
    "image": "https://www.sephora.com/productimages/sku/s2961324-main-hero.jpg",
    "url": "https://www.sephora.com/product/lip-sleeping-mask-P420652",
    "rating": 4.32,
    "review_count": 22324,
    "variants": [
      {
        "sku": "2961324",
        "name": "Lip Sleeping Mask - Acai Mango Smoothie",
        "color": "Acai Mango Smoothie",
        "image": "https://www.sephora.com/productimages/sku/s2961324-main-hero.jpg",
        "price": "25.00",
        "currency_code": "USD",
        "availability": "InStock"
      },
      {
        "sku": "2743243",
        "name": "Lip Sleeping Mask - Watermelon Pop",
        "color": "Watermelon Pop",
        "price": "24.00",
        "currency_code": "USD",
        "availability": "OutOfStock"
      }
    ],
    "review_sample": [
      {
        "id": "400508718",
        "author": "megankiers",
        "title": "Love this!!!",
        "body": "This is my favorite product I've got at Sephora!",
        "rating": 5,
        "date_published": "2026-08-15"
      }
    ],
    "source_url": "https://www.sephora.com/product/lip-sleeping-mask-P420652",
    "fetched_at": "2026-08-15T12:00:00Z"
  }
}

Request schema

No body schema

Response schema

#/definitions/sephora.productResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	sephora.ProductResponse	No
data.brand	string	No	LANEIGE
data.category	string	No
data.description	string	No
data.fetched_at	string	No
data.image	string	No
data.name	string	No
data.product_group_id	string	No	P420652
data.rating	number	No	4.3
data.review_count	integer	No
data.review_sample	array	No
data.review_sample[].author	string	No
data.review_sample[].body	string	No
data.review_sample[].date_published	string	No
data.review_sample[].id	string	No
data.review_sample[].rating	number	No
data.review_sample[].title	string	No
data.source_url	string	No
data.url	string	No
data.variants	array	No
data.variants[].availability	string	No	InStock
data.variants[].color	string	No	Acai Mango Smoothie
data.variants[].currency_code	string	No	USD
data.variants[].image	string	No
data.variants[].name	string	No
data.variants[].price	string	No	25.00
data.variants[].sku	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/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/product?product_id=lip-sleeping-mask-P420652" \
  -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 storefront categories API documentation Sephora category browse 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 product detail API

GETapiKey3 credits/requestSephorasephora.productResponseDoc/sephora/product

Endpoint facts

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

Sephora Scraper API Try Sephora product detail API in Playground Sephora API documentation

How this endpoint behaves

Query parameters:

product_id: required. The full Sephora product-page slug, e.g. lip-sleeping-mask-P420652 -- copy it from the path segment after sephora.com/product/ on any product page. Unlike some other retailers, an arbitrary or partial slug does not resolve to the real product; the full slug is required.

Notable response behavior:

variants lists every purchasable color/shade of the product, each with its own sku, price, currency_code, and availability (InStock or OutOfStock).
review_sample is a small sample of recent reviews embedded on the product page itself, not the full review set -- there is currently no separate paginated reviews endpoint for this family.
An unresolved or malformed product_id returns 404.

Live monitoring

Monitored request: GET /sephora/product?product_id=lip-sleeping-mask-P420652
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.36 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /sephora/product?product_id=lip-sleeping-mask-P420652
Items in review_sample: 10
Fields filled in every checked item: 5
Fields empty in some or all items: 1

Field	Filled in, of 10 checked	Values in the sample
id	10
author	10
title	6	“not good” and 5 other values
body	10	median 163 characters
rating	10	1 to 5, median 4
date_published	10	2021-01-04 to 2026-10-11

Request parameters

Parameter	Type	Required	Default	Description	Example
product_id	string	Yes		Full Sephora product-page slug	lip-sleeping-mask-P420652
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/sephora/product?product_id=lip-sleeping-mask-P420652" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "product_group_id": "P420652",
    "name": "Lip Sleeping Mask – Intense Hydration Lip Treatment with Vitamin C",
    "description": "Shop LANEIGE's Lip Sleeping Mask at Sephora.",
    "brand": "LANEIGE",
    "category": "lip-balm-lip-care",
    "image": "https://www.sephora.com/productimages/sku/s2961324-main-hero.jpg",
    "url": "https://www.sephora.com/product/lip-sleeping-mask-P420652",
    "rating": 4.32,
    "review_count": 22324,
    "variants": [
      {
        "sku": "2961324",
        "name": "Lip Sleeping Mask - Acai Mango Smoothie",
        "color": "Acai Mango Smoothie",
        "image": "https://www.sephora.com/productimages/sku/s2961324-main-hero.jpg",
        "price": "25.00",
        "currency_code": "USD",
        "availability": "InStock"
      },
      {
        "sku": "2743243",
        "name": "Lip Sleeping Mask - Watermelon Pop",
        "color": "Watermelon Pop",
        "price": "24.00",
        "currency_code": "USD",
        "availability": "OutOfStock"
      }
    ],
    "review_sample": [
      {
        "id": "400508718",
        "author": "megankiers",
        "title": "Love this!!!",
        "body": "This is my favorite product I've got at Sephora!",
        "rating": 5,
        "date_published": "2026-08-15"
      }
    ],
    "source_url": "https://www.sephora.com/product/lip-sleeping-mask-P420652",
    "fetched_at": "2026-08-15T12:00:00Z"
  }
}

Request schema

No body schema

Response schema

#/definitions/sephora.productResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	sephora.ProductResponse	No
data.brand	string	No	LANEIGE
data.category	string	No
data.description	string	No
data.fetched_at	string	No
data.image	string	No
data.name	string	No
data.product_group_id	string	No	P420652
data.rating	number	No	4.3
data.review_count	integer	No
data.review_sample	array	No
data.review_sample[].author	string	No
data.review_sample[].body	string	No
data.review_sample[].date_published	string	No
data.review_sample[].id	string	No
data.review_sample[].rating	number	No
data.review_sample[].title	string	No
data.source_url	string	No
data.url	string	No
data.variants	array	No
data.variants[].availability	string	No	InStock
data.variants[].color	string	No	Acai Mango Smoothie
data.variants[].currency_code	string	No	USD
data.variants[].image	string	No
data.variants[].name	string	No
data.variants[].price	string	No	25.00
data.variants[].sku	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/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/product?product_id=lip-sleeping-mask-P420652" \
  -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 product detail 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 product detail 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