Endpoint Playground
Test Crawlora's Sephora category browse 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/category?slug=<slug>&sort_by=featured" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| slug | string | Yes | 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"
}
}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.
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.
{
"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"
}
}curl "https://api.crawlora.net/api/v1/sephora/category?slug=<slug>" \
-H "x-api-key: $CRAWLORA_API_KEY"