Endpoint Playground
Test Crawlora's Sephora product search API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.
curl "https://api.crawlora.net/api/v1/sephora/search?query=<query>&sort_by=featured" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| query | string | Yes | Search keyword | |
| page | integer | No | Result page, 1-based, defaults to 1 | |
| page_size | integer | No | Results per page, 1 to 100, defaults to 60 | |
| sort_by | string | No | featured | Sort order, defaults to featured |
| price_min | integer | No | Minimum price in whole dollars; must be set together with price_max | |
| price_max | integer | No | Maximum price in whole dollars; must be set together with price_min | |
| brand | array | No | One or more exact brand names to filter to (OR'd together); repeat the param for multiple values | |
| rating_min | integer | No | Minimum star rating, 1 to 4 | |
| is_new | boolean | No | When true, filters to products flagged New | |
| filter | array | No | Additional facet:value filters, repeat the param for multiple; facet must be one of: benefits, ingredientpreferences, colorfamily, formulation, size, shoppingpreferences, agerange, skintype, finish, skinconcerns, coverage, hairtype, hairconcerns, hairtexture |
{
"code": 200,
"msg": "OK",
"data": {
"query": "mascara",
"page": 1,
"page_size": 60,
"sort_by": "featured",
"total_products": 180,
"count": 2,
"related_searches": [
"foundation",
"highlighter"
],
"products": [
{
"product_id": "P520769",
"sku_id": "2948230",
"brand_name": "tarte",
"product_name": "Mini Shape Tape Concealer + Tubing Mascara Set",
"list_price": "$25.00",
"value_price": "$30.00",
"rating": 5,
"review_count": 2,
"more_colors": 8,
"image_url": "https://www.sephora.com/productimages/sku/s2948230-main-zoom.jpg",
"url": "https://www.sephora.com/product/travel-size-shape-tape-tubing-set-P520769?skuId=2948230"
},
{
"product_id": "P446676",
"sku_id": "1234567",
"brand_name": "Lancôme",
"product_name": "Lash Idôle Lengthening & Volumizing Mascara",
"list_price": "$29.00",
"rating": 4.5,
"review_count": 9021,
"sponsored": true,
"image_url": "https://www.sephora.com/productimages/sku/s1234567-main-zoom.jpg",
"url": "https://www.sephora.com/product/lash-idole-P446676"
}
],
"source_url": "https://www.sephora.com/api/v2/catalog/search/?...",
"fetched_at": "2026-08-15T12:00:00Z"
}
}Public Playground
Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.
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).
{
"code": 200,
"msg": "OK",
"data": {
"query": "mascara",
"page": 1,
"page_size": 60,
"sort_by": "featured",
"total_products": 180,
"count": 2,
"related_searches": [
"foundation",
"highlighter"
],
"products": [
{
"product_id": "P520769",
"sku_id": "2948230",
"brand_name": "tarte",
"product_name": "Mini Shape Tape Concealer + Tubing Mascara Set",
"list_price": "$25.00",
"value_price": "$30.00",
"rating": 5,
"review_count": 2,
"more_colors": 8,
"image_url": "https://www.sephora.com/productimages/sku/s2948230-main-zoom.jpg",
"url": "https://www.sephora.com/product/travel-size-shape-tape-tubing-set-P520769?skuId=2948230"
},
{
"product_id": "P446676",
"sku_id": "1234567",
"brand_name": "Lancôme",
"product_name": "Lash Idôle Lengthening & Volumizing Mascara",
"list_price": "$29.00",
"rating": 4.5,
"review_count": 9021,
"sponsored": true,
"image_url": "https://www.sephora.com/productimages/sku/s1234567-main-zoom.jpg",
"url": "https://www.sephora.com/product/lash-idole-P446676"
}
],
"source_url": "https://www.sephora.com/api/v2/catalog/search/?...",
"fetched_at": "2026-08-15T12:00:00Z"
}
}curl "https://api.crawlora.net/api/v1/sephora/search?query=<query>" \
-H "x-api-key: $CRAWLORA_API_KEY"