Endpoint Playground
Returns one page of a Sephora category/browse listing (e.g. Makeup, Skincare), with the same sort and facet filters as /sephora/search. slug is the path segment after sephora.com/shop/, e.g. makeup-cosmetics. The response uses Sephora's public catalog search to keep browse listings available when the category page's legacy embedded data is absent.
14 Oct 2026: 60 products; 7 fields had a value in every checked item and 4 varied between items.
Sample value profiles: brand_name: Benefit Cosmetics (29), MAC Cosmetics (19), IT Cosmetics (7) and 2 more; rating: 2 to 5, median 4.38; product_name: “Mini Fan Fest Fanning & Volumizing Mascara” and 59 other values.
curl 'https://api.crawlora.net/api/v1/sephora/category?slug=makeup-cosmetics&sort_by=featured' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| slug | string | Yes | makeup-cosmetics | Category-page slug |
| page | integer | No | Result page, 1-based, defaults to 1 | |
| 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": {
"slug": "makeup-cosmetics",
"display_name": "makeup cosmetics",
"page": 1,
"page_size": 60,
"sort_by": "featured",
"total_products": 2492,
"count": 2,
"related_categories": [
"Face",
"Fragrance"
],
"products": [
{
"product_id": "P467208",
"sku_id": "2417145",
"brand_name": "Lancôme",
"product_name": "Lash Idôle Lengthening & Volumizing Mascara",
"list_price": "$16.00 - $30.00",
"rating": 4.5012,
"review_count": 10757,
"more_colors": 2,
"image_url": "https://www.sephora.com/productimages/sku/s2417145-main-zoom.jpg",
"url": "https://www.sephora.com/product/lancome-lash-idole-lash-lifting-volumizing-mascara-P467208?skuId=2417145"
}
],
"source_url": "https://www.sephora.com/shop/makeup-cosmetics?currentPage=1",
"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.