# Sephora Search API (https://www.socialcrawl.dev/platforms/sephora/search)

> Returns Sephora US products matching a keyword, 60 per page by default, each with product id, title, brand, price range, rating, review count, and image. Pagination is clean: page 2 of moisturizer had 60 new ids and zero overlap with page 1. A query that matches nothing is returned as an empty page and is not billed. min_rating is honoured. new sort returned the same ids as best_selling on the moisturizer probe, so prefer top_rated or price_low when you need a different order.

TL;DR: `GET /v1/sephora/search` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search keyword, for example moisturizer or niacinamide. |
| `page` | no | Page number, starting at 1. Prefer the universal cursor parameter. |
| `page_size` | no | Products per page, 1 to 60. Default 60. |
| `sort_by` | no | Result ordering: best_selling (default), top_rated, price_low, price_high, or new. On a moisturizer keyword search, new returned the same ids as best_selling, so treat new as unverified. (best_selling \| top_rated \| price_low \| price_high \| new) |
| `min_rating` | no | Keep products whose average rating is at least this, 1 to 5. |
| `min_price` | no | Minimum list price in US dollars. |
| `max_price` | no | Maximum list price in US dollars. |
| `is_new` | no | When true, keep products Sephora flags as new. |
| `category_id` | no | Optional category id from GET /v1/sephora/categories to narrow the search. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/sephora/search?query=moisturizer" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

See the full Sephora API: https://www.socialcrawl.dev/platforms/sephora

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing