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

---

# Sephora Product Search API

Search Sephora's catalogue by keyword and get priced, rated products with the filters the store offers.

`GET /v1/sephora/search?query=vitamin%20c%20serum` returns `data.products`, `data.totalResults`, `data.facets` and `data.relatedSearches`. Each product has `id`, `name`, `brand`, `url`, `skuId`, `imageUrl`, `rating`, `reviewCount`, `price`, `listPrice`, `valuePrice`, `size`, `variationType`, `variantCount` and flags such as `isOnSale`, `isNew` and `isBestseller`. `facets` lists the store's filters (brand, skin type, price, ingredients and more) with product counts.

Order with `sort` (`relevance`, `bestselling`, `top_rated`, `newest`, `price_high_to_low`, `price_low_to_high`), set `limit` up to 60 and follow `page.nextCursor`. The store returns its closest products even for words it doesn't know, so check `totalResults` and the products themselves.

## Request

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

## FAQ

### How many products does one request return?

Up to 60, set with limit. Follow page.nextCursor while page.hasMore is true for the rest; each page is its own request.

### Can I sort by price or bestselling?

Yes. sort accepts relevance, bestselling, top_rated, newest, price_high_to_low and price_low_to_high.

### What are facets?

The filters the store shows next to the results, such as Brand, skinType or Price, with how many matching products each option has. Use them to see a search's spread by brand or concern.

### Is a search with no exact match empty?

Not always. The store also returns related products for words it doesn't recognise, the same way its own search box does.

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