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

> The SocialCrawl Sephora API returns Sephora's US catalogue as JSON across 11 endpoints. Product returns title, brand, description, price, rating, images, ingredients and stock. Search, category and brand/products return 60 products per page, reviews returns 10 per page with text and star rating, and stores and availability find nearby stores and store-level stock for a sku.

TL;DR: SocialCrawl's Sephora API exposes 11 endpoints, 1 to 9 credits per call, all returning one unified JSON schema with computed fields such as engagement rate, language and content category. Single x-api-key auth, 100 free credits on signup.

## Endpoints

| Endpoint | Method | Path | Credits | Description |
| --- | --- | --- | --- | --- |
| Product | GET | `/v1/sephora/product` | 5 | Get a Sephora product by id or URL |
| Reviews | GET | `/v1/sephora/reviews` | 5 to 9 | Get Sephora product reviews |
| Search | GET | `/v1/sephora/search` | 5 | Search Sephora products by keyword |
| Search Suggestions | GET | `/v1/sephora/search/suggestions` | 1 | Get Sephora search suggestions |
| Category | GET | `/v1/sephora/category` | 5 | Browse Sephora products in a category |
| Categories | GET | `/v1/sephora/categories` | 1 | List Sephora root categories |
| Category Data | GET | `/v1/sephora/category/data` | 1 | Get a Sephora category and its children |
| Brands | GET | `/v1/sephora/brands` | 1 | List Sephora brands |
| Brand Products | GET | `/v1/sephora/brand/products` | 5 | List Sephora products for a brand |
| Stores | GET | `/v1/sephora/stores` | 1 | Find Sephora stores near a coordinate |
| Availability | GET | `/v1/sephora/availability` | 5 | Get Sephora in-store availability for a sku |

## 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"
```

Every response shares one JSON envelope: `{ success, platform, endpoint, data, credits_used, credits_remaining }`.

## FAQ

### What data can I get from the SocialCrawl Sephora API?

It returns product detail (title, brand, description, list price, rating, review count, images, ingredients, size and in-stock flag), written reviews, keyword search, category and brand catalogues, search suggestions, store locations and store-level stock for a sku. All of it comes back as JSON.

### Can I search Sephora products by keyword?

Yes, search takes a keyword such as a product name and returns 60 products per page with product id, title, brand, price, rating and image. There is no ingredient filter, so read ingredients from the product endpoint. You can narrow search with category_id or min_price and max_price in US dollars. A query that matches nothing comes back empty and is not billed.

### How do I pull every review for a Sephora product?

Call reviews with the product id, the P-number such as P427414, or the product URL. Pages hold 10 reviews by default and up to 100, sorted by most_helpful, highest_rating, lowest_rating, oldest or newest, and rating keeps one star value. The star average is already on the product endpoint.

### Can I check if a Sephora product is in stock at a nearby store?

Yes, availability takes a sku from product detail plus a lat,lng and returns each store's id, name, distance and an in-stock flag. The radius is 1 to 100 miles, default 50. National in-stock status is already on the product endpoint.

### How do I walk a Sephora brand or category catalogue?

brands returns each brand's id and short name, and brand/products takes a short name and returns 60 products per page. For categories, start at categories, use category/data to get the children of a node, then page through category.

### Does the Sephora API cover countries outside the US?

It covers Sephora's US catalogue. The language parameter on product switches the copy between en-US, en-CA and fr-CA, but listings and amounts are the US ones. Credits for failed or empty calls are refunded automatically.

## 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:

- How do I get Sephora product reviews and ingredients with the SocialCrawl API?
- Can SocialCrawl check Sephora in-store stock near a location?
- Is there a Sephora API for product and brand data? Does SocialCrawl have one?