Docs menu

API Reference

Sephora API Documentation

Use Crawlora's Sephora API endpoints to extract supported public Sephora data as structured JSON. This documentation covers 4 active endpoints including Sephora product detail, Sephora product questions and answers, Sephora product reviews, Sephora product search. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as product_id, query, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.

Try Sephora product search Start with endpoint docs Pricing

Quick start

Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.

Base URL: https://api.crawlora.net/api/v1
Auth header: x-api-key: $CRAWLORA_API_KEY
Primary endpoint: GET /sephora/search
Credit cost: 3 credits/request

curl -X GET "https://api.crawlora.net/api/v1/sephora/search?query=coffee&page=1&sort_by=featured&is_new=true" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Try Sephora product search in Playground API key authentication Review Crawlora pricing

Sephora API endpoints

These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.

GET/sephora/productapiKey3 credits/request

Sephora product detail

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), from Sephora's credential-free public JSON-LD. `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.

Required params: product_id:query

Sephora product detail documentation Try Sephora product detail in Playground

GET/sephora/product/questionsapiKey3 credits/request

Sephora product questions and answers

Returns one page of a Sephora product's customer Q&A: each question plus every answer it received (text, author, whether it's a brand answer, helpful votes). product_id is the Sephora productGroupID, e.g. P420652 -- the same value /sephora/product returns as product_group_id.

Required params: product_id:query

Sephora product questions and answers documentation Try Sephora product questions and answers in Playground

GET/sephora/product/reviewsapiKey3 credits/request

Sephora product reviews

Returns one page of a Sephora product's full customer reviews (title, body, rating, author, helpful votes, secondary ratings, photos), plus the product's site-wide rating rollup (average rating, recommended ratio, star-count histogram). product_id is the Sephora productGroupID, e.g. P420652 -- the same value /sephora/product returns as product_group_id.

Required params: product_id:query

Sephora product reviews documentation Try Sephora product reviews in Playground

GET/sephora/searchapiKey3 credits/request

Sephora product search

Searches Sephora's product catalog by keyword, with real page-based pagination. Returns normalized products with brand, pricing, rating, and review count. Sephora's own search never returns a genuine zero-result state for a nonempty keyword -- an unrecognized/nonsense keyword still returns a full, unrelated fallback result set rather than an empty one. price_min/price_max must be provided together (whole dollars) -- upstream silently ignores a one-sided price range rather than filtering or erroring, so this endpoint rejects a one-sided range as invalid instead of passing it through. brand and filter each accept multiple values (OR'd together within the same facet); brand/rating_min/is_new/filter/price_min/price_max can all be combined with each other (AND'd together across different facets).

Required params: query:query

Sephora product search documentation Try Sephora product search in Playground

Endpoint reference table

Endpoint	API path	Method	Credits	Required params	Docs	Playground
Sephora product detail	/sephora/product	GET	3 credits/request	product_id:query	View docs	Try endpoint
Sephora product questions and answers	/sephora/product/questions	GET	3 credits/request	product_id:query	View docs	Try endpoint
Sephora product reviews	/sephora/product/reviews	GET	3 credits/request	product_id:query	View docs	Try endpoint
Sephora product search	/sephora/search	GET	3 credits/request	query:query	View docs	Try endpoint

Related Crawlora API pages

Sephora Scraper API Try the primary endpoint in Playground Browse supported platforms Crawlora API pricing Amazon API documentation eBay API documentation Shop.app API documentation Shopify API documentation

Back to docs

Docs menu

API Reference

Sephora API Documentation

Try Sephora product search Start with endpoint docs Pricing

Quick start

Base URL: https://api.crawlora.net/api/v1
Auth header: x-api-key: $CRAWLORA_API_KEY
Primary endpoint: GET /sephora/search
Credit cost: 3 credits/request

curl -X GET "https://api.crawlora.net/api/v1/sephora/search?query=coffee&page=1&sort_by=featured&is_new=true" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Try Sephora product search in Playground API key authentication Review Crawlora pricing

Sephora API endpoints

These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.

GET/sephora/productapiKey3 credits/request

Sephora product detail

Required params: product_id:query

Sephora product detail documentation Try Sephora product detail in Playground

GET/sephora/product/questionsapiKey3 credits/request

Sephora product questions and answers

Required params: product_id:query

Sephora product questions and answers documentation Try Sephora product questions and answers in Playground

GET/sephora/product/reviewsapiKey3 credits/request

Sephora product reviews

Required params: product_id:query

Sephora product reviews documentation Try Sephora product reviews in Playground

GET/sephora/searchapiKey3 credits/request

Sephora product search

Required params: query:query

Sephora product search documentation Try Sephora product search in Playground

Endpoint reference table

Endpoint	API path	Method	Credits	Required params	Docs	Playground
Sephora product detail	/sephora/product	GET	3 credits/request	product_id:query	View docs	Try endpoint
Sephora product questions and answers	/sephora/product/questions	GET	3 credits/request	product_id:query	View docs	Try endpoint
Sephora product reviews	/sephora/product/reviews	GET	3 credits/request	product_id:query	View docs	Try endpoint
Sephora product search	/sephora/search	GET	3 credits/request	query:query	View docs	Try endpoint

Related Crawlora API pages

Back to docs