# Sephora Category API (https://www.socialcrawl.dev/platforms/sephora/category)

> Returns products in a Sephora category, 60 per page, each with product id, title, brand, price, rating, and image. The category total is exact (Luxury Beauty was 1157). Feed a category id from GET /v1/sephora/categories or GET /v1/sephora/category/data.

TL;DR: `GET /v1/sephora/category` 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 |
| --- | --- | --- |
| `category_id` | yes | Sephora category id, for example cat1100057 for Luxury Beauty. Ids come from GET /v1/sephora/categories. |
| `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_price` | no | Minimum list price in US dollars. |
| `max_price` | no | Maximum list price in US dollars. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/sephora/category?category_id=cat1100057" \
  -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