> **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/product>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/sephora/product.mdx>

---

# Sephora Product API

Look up any Sephora product by its id or page URL and read every shade and size, with prices and stock flags.

`GET /v1/sephora/product?productId=P442563` returns `data.product` with `id`, `name`, `url`, `brand`, `category` and `breadcrumbs`, `rating`, `reviewCount`, `lovesCount`, the plain-text `description`, `longDescription` and `suggestedUsage`, and `skus`: every shade and size with `price`, `listPrice`, `salePrice`, `valuePrice`, images, stock and delivery flags, attributes and the ingredient list.

Pass a product id such as `P442563` or a full product page URL. Add `skuId` to open the product on one shade; `selectedSkuId` echoes it. A product Sephora no longer carries comes back as `lookupStatus: not_found` with `product: null`.

## Request

- **Endpoint:** `GET /v1/sephora/product`
- **Credits:** 1 credit
Failed requests are free
Found, empty and not-found answers are all charged
- **Input:** by product id or URL
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/sephora/product/get)
- **Platform page:** [/platforms/sephora](https://www.socialfetch.dev/platforms/sephora)

## FAQ

### What can I pass as productId?

A product id such as P442563, or a sephora.com product page URL such as https://www.sephora.com/product/aha-30-bha-2-peeling-solution-P442563. A URL with ?skuId= also selects that shade.

### Are all shades and sizes included?

Yes. data.product.skus lists every shade and size in the site's order, each with its own id, prices, images, stock flags and attributes such as skin type or finish.

### How are prices returned?

As numbers in data.product.currency (USD). price is what the shopper pays now; listPrice is the regular price; salePrice is set only when the sku is on sale; valuePrice is the stated value of a set or kit. priceText keeps the price as the site writes it.

### What happens for a product that is no longer sold?

The lookup returns lookupStatus: not_found with product: null, and it is still a completed request.

### How many credits does a request cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
