Endpoint Playground
Returns Sephora's own search-box type-ahead suggestions for a partial keyword: keyword-completion terms, matching products, and trending/related categories. Sephora's own upstream never returns a genuine zero-result state for a nonempty query -- a deliberately nonsense query still returns unrelated product suggestions.
14 Oct 2026: 5 products; 7 fields had a value in every checked item.
Sample value profiles: rating: 3.72 to 4.44, median 4.12; brand_name: “Benefit Cosmetics” and 4 other values; image_url: sephora.com.
curl 'https://api.crawlora.net/api/v1/sephora/suggest?query=masc' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| query | string | Yes | masc | Partial search keywords |
{
"code": 200,
"msg": "OK",
"data": {
"query": "masc",
"terms": [
{
"term": "mascara"
},
{
"term": "mascara smudge proof"
}
],
"products": [
{
"product_id": "P431750",
"sku_id": "2850378",
"brand_name": "ILIA",
"product_name": "Limitless Lash Mascara - Clean Lengthening Mascara",
"rating": 4.1361,
"review_count": 7773,
"image_url": "https://www.sephora.com/productimages/sku/s2850378-main-thumb-50.jpg"
}
],
"categories": [
{
"name": "Mascara",
"url": "https://www.sephora.com/shop/mascara"
}
],
"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.