sephora_search
Search Sephora’s product catalog by keyword, filter by brand, price, ratings, and facets, and retrieve normalized product data with pricing and review counts.
Instructions
Sephora product search. Searches Sephora's product catalog by keyword, with real page-based pagination. Returns normalized 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).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Result page, 1-based, defaults to 1 | |
| brand | No | One or more exact brand names to filter to (OR'd together); repeat the param for multiple values | |
| query | Yes | Search keyword | |
| filter | 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 | |
| is_new | No | When true, filters to products flagged New | |
| sort_by | No | Sort order, defaults to featured | |
| page_size | No | Results per page, 1 to 100, defaults to 60 | |
| price_max | No | Maximum price in whole dollars; must be set together with price_min | |
| price_min | No | Minimum price in whole dollars; must be set together with price_max | |
| rating_min | No | Minimum star rating, 1 to 4 |