# Sephora Product API (https://www.socialcrawl.dev/platforms/sephora/product)

> Returns one Sephora US product: title, brand, description, list price, rating, review count, images, ingredients, size, and in-stock flag. Pass the P-number (P427414) or the full sephora.com/product URL. Optional sku pins a size or colour variant. Optional language is en-US, en-CA, or fr-CA. For written reviews call GET /v1/sephora/reviews with the same product id. For store stock call GET /v1/sephora/availability with the sku.

TL;DR: `GET /v1/sephora/product` 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 |
| --- | --- | --- |
| `product_id` | no | Sephora product id, the P-number at the end of a product URL: sephora.com/product/the-ordinary-deciem-natural-moisturizing-factors-ha-P427414 is product id P427414. Product ids also come back on every row of GET /v1/sephora/search and GET /v1/sephora/category. |
| `url` | no | Full Sephora product URL, for example https://www.sephora.com/product/the-ordinary-deciem-natural-moisturizing-factors-ha-P427414. The product id is extracted from the path. |
| `sku` | no | Sephora sku id for a size or colour variant, for example 2210581. Comes back on search rows as currentSku.skuId and on product detail as currentSku.skuId. |
| `language` | no | Copy locale: en-US (default), en-CA, or fr-CA. (en-US \| en-CA \| fr-CA) |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/sephora/product" \
  --data-urlencode "product_id=P427414" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the Sephora Product API return?

Returns one Sephora product by id or URL: title, brand, description, price, rating, images, ingredients, and whether it is in stock. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields.

### When should I use the Sephora Product endpoint?

Use it when you already have a product id (P427414) or a sephora.com/product URL. For discovery, start at search or category.

### How much does the Sephora Product API cost?

Each call costs 5 credits, so the 100 free credits every new account gets cover 20 calls. Credits for failed or empty calls are refunded automatically, and there is no subscription.

### What parameters does the Sephora Product API need?

Identify the target with one of product_id, url. It also accepts 4 optional parameters, all listed on this page.

### How do I call the Sephora Product API?

Send a GET request to https://www.socialcrawl.dev/v1/sephora/product?product_id=P427414 with your API key in the x-api-key header. An Authorization: Bearer header works too.

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

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- What does the SocialCrawl Sephora Product API return?
- How do I get Sephora Product data with the SocialCrawl API?