# Sephora Brand Products API (https://www.socialcrawl.dev/platforms/sephora/brand-products)

> Returns products from one Sephora brand, 60 per page, each with product id, title, brand, price, rating, and image. The brand total is exact (Gucci was 64). Pass the brand short name from GET /v1/sephora/brands, for example gucci.

TL;DR: `GET /v1/sephora/brand/products` 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 |
| --- | --- | --- |
| `id` | yes | Brand short name from GET /v1/sephora/brands, for example gucci or AAVRANI. |
| `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. |
| `min_rating` | no | Keep products whose average rating is at least this, 1 to 5. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/sephora/brand/products?id=gucci" \
  -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