> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/sephora>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/sephora.mdx>

---

# Sephora API. Products, reviews and stores as JSON.

Look up any product with every shade and price, page through its reviews and questions, search and browse the catalogue by category or brand, and list the stores. Every response uses the same envelope.

- Products + prices
- Reviews and Q&A
- 1 credit per request

`GET /v1/sephora/product` is the center of the Sephora API. A product carries its brand, category path, rating, review count and loves, the plain-text description, usage and ingredients, and `skus`: every shade and size with its price, list price, sale price, images, stock flags and attributes such as skin type or finish. Pass a product id like `P442563` or the product page URL.

Around it, `/v1/sephora/product/reviews` and `/product/questions` page through what shoppers wrote, with review statistics and the reviewer's own skin type and age range. `/search`, `/category/products` and `/brand/products` return the same product cards with prices and ratings, the store's filters with counts, and a cursor. `/categories`, `/category` and `/brands` describe the catalogue, and `/stores` and `/store` list every store in the United States and Canada with addresses, coordinates and hours. Every answer is JSON in the `{ data, meta }` envelope with `data.lookupStatus`; a miss is `not_found`, not an HTTP error.

## What you can get

- Product detail with every shade and size, prices, sale and value prices, images, stock and delivery flags, ingredients and highlights.
- Product reviews with ratings, reviewer attributes, photos, helpful votes and brand replies, plus rating distribution and averages.
- Shopper questions with their answers, including answers from the brand.
- Keyword search and search suggestions, with prices, ratings and the store's filters.
- The category tree, one category with its parents and children, and every product in a category.
- Every brand with product counts, a brand's products, and US and Canadian stores with hours and coordinates.

## Sephora endpoints

| Endpoint | Request | Credits | Docs |
| --- | --- | --- | --- |
| Product | GET /v1/sephora/product | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/sephora/product/get) |
| Product reviews | GET /v1/sephora/product/reviews | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/sephora/product/reviews/get) |
| Product questions | GET /v1/sephora/product/questions | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/sephora/product/questions/get) |
| Search | GET /v1/sephora/search | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/sephora/search/get) |
| Search suggestions | GET /v1/sephora/search/suggestions | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/sephora/search/suggestions/get) |
| Categories | GET /v1/sephora/categories | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/sephora/categories/get) |
| Category | GET /v1/sephora/category | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/sephora/category/get) |
| Category products | GET /v1/sephora/category/products | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/sephora/category/products/get) |
| Brands | GET /v1/sephora/brands | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/sephora/brands/get) |
| Brand products | GET /v1/sephora/brand/products | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/sephora/brand/products/get) |
| Stores | GET /v1/sephora/stores | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/sephora/stores/get) |
| Store | GET /v1/sephora/store | 1 credit Failed requests are free Found, empty and not-found answers are all charged | [docs](https://www.socialfetch.dev/docs/api/v1/sephora/store/get) |

## How to start

1. **Create an API key.** Sign up at Social Fetch and copy a key (`sfk_…`). New accounts get 100 free credits, enough to try every Sephora route.
2. **Pick the product, category, brand or store.** Use a product id or URL, for example `GET /v1/sephora/product?productId=P442563`, a category such as `cat150006`, a brand such as `The Ordinary`, or a store slug such as `centerra`. Send `x-api-key` on every request.
3. **Branch and page.** Check `data.lookupStatus` before you store a row. Keep requesting with `page.nextCursor` while `page.hasMore` is true, and bill from `meta.creditsCharged`.

## Pricing

Each Sephora route charges a flat credit amount per completed request, shown on every endpoint page. Each page of a list is its own request. Credits never expire on pay-as-you-go packs, and `meta.creditsCharged` on every response is the billing source of truth.

## Compared with the official API

Sephora offers no public developer API for its catalogue. Social Fetch gives every route one JSON shape: prices as numbers with a currency, plain text instead of page markup, ISO 8601 UTC dates, typed `lookupStatus` answers and opaque cursors that continue the same list and filters. You do not need an account or a session.

## FAQ

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

Products with every shade and size, prices, stock flags and ingredients; product reviews with statistics; shopper questions and answers; keyword search and search suggestions; the category tree, single categories and category products; every brand and a brand's products; and US and Canadian stores with addresses, coordinates and hours.

### How do I name a Sephora product?

Use its product id, such as P442563, or its product page URL. Add skuId to open a particular shade or size. A product Sephora no longer carries returns data.lookupStatus: not_found.

### Are prices in the response numbers?

Yes. price, listPrice, salePrice and valuePrice are numbers in the product's currency (USD). salePrice is null unless the sku is on sale; priceText keeps the price as the site writes it.

### How do I get every review of a product?

Call /v1/sephora/product/reviews with limit up to 100 and follow page.nextCursor while page.hasMore is true. Each page is one request. Filter by star rating with rating and order with sort.

### Can I list a brand's whole catalogue?

Yes. /v1/sephora/brand/products takes the brand's name in any case, its slug or its page URL, and pages through every product with prices and ratings. /v1/sephora/brands lists every brand with its product count.

### Can I find stores near a location?

/v1/sephora/stores lists stores by country and state, including Sephora shops inside Kohl's, and /v1/sephora/store returns each store's coordinates, so you can compute distances yourself. A search by coordinates is not offered yet.

### Is a search with no match an error?

No. Search returns lookupStatus: found. The store also returns its closest products for words it doesn't recognise, so check totalResults and the products themselves.

### How much does the Sephora API cost?

Every Sephora route charges a flat amount per completed request, shown on each endpoint page, and each page of a list is billed separately. A found, empty or not-found answer is a completed request and costs that amount; invalid requests and errors are free. Check meta.creditsCharged on every response. New accounts start with 100 free credits.

## Related

- [Sephora Product API](https://www.socialfetch.dev/platforms/sephora/product): Every shade and size with prices and ingredients (`GET /v1/sephora/product`).
- [Sephora Product Reviews API](https://www.socialfetch.dev/platforms/sephora/product-reviews): Reviews with ratings, photos and statistics (`GET /v1/sephora/product/reviews`).
- [Sephora Product Search API](https://www.socialfetch.dev/platforms/sephora/search): Keyword search with prices, ratings and filters (`GET /v1/sephora/search`).
- [Sephora Stores API](https://www.socialfetch.dev/platforms/sephora/stores): Every store by country and state (`GET /v1/sephora/stores`).
- [Ask in plain English](https://www.socialfetch.dev/ask): Route a natural-language Sephora question to the matching operation.
- [Hosted MCP](https://www.socialfetch.dev/mcp): Call Sephora tools from Cursor or Claude with the same credit metering as REST.
