Sephora

Sephora category browse

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.

get/sephora/category

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/sephora/category
  • Auth: API key in header x-api-key

Query parameters

slugstring required

Category-page slug

pageinteger

Result page, 1-based, defaults to 1

sort_by'featured' | 'top_rated' | 'new' | 'best_selling' | 'price_low_to_high' | 'price_high_to_low'

Sort order, defaults to featured

price_mininteger

Minimum price in whole dollars; must be set together with price_max

price_maxinteger

Maximum price in whole dollars; must be set together with price_min

brandstring[]

One or more exact brand names to filter to (OR'd together); repeat the param for multiple values

rating_mininteger

Minimum star rating, 1 to 4

is_newboolean

When true, filters to products flagged New

filterstring[]

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

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "display_name": "Makeup",
    "page": 1,
    "page_size": 60,
    "products": [
      {
        "brand_name": "tarte",
        "list_price": "$25.00",
        "product_id": "P520769",
        "rating": 4.5
      }
    ],
    "slug": "makeup-cosmetics",
    "sort_by": "featured",
    "total_products": 2492
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.