Endpoint Playground
Searches Sephora's product catalog by keyword, with real page-based pagination. Returns 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).
14 Oct 2026: 40 products; 9 fields had a value in every checked item and 1 varied between items.
Sample value profiles: rating: 3.7 to 4.76, median 4.16; brand_name: “Lancôme” and 22 other values; image_url: sephora.com.
curl 'https://api.crawlora.net/api/v1/sephora/search?query=mascara&sort_by=featured' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| query | string | Yes | mascara | 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"
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.