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

---

# Sephora Category Products API

Browse any Sephora category's products, sorted by bestselling, rating, price or newest.

`GET /v1/sephora/category/products?category=cat60004` returns `data.category`, `data.products`, `data.totalResults` and `data.facets`, with the same product cards as search. Pass a category id, page URL or slug, sort with `sort`, set `limit` up to 60 and follow `page.nextCursor`. A category the store doesn't have is `lookupStatus: not_found`.

## Request

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

## FAQ

### Can I track a category's bestsellers?

Yes. sort=bestselling returns the category in the store's bestselling order; run it on a schedule to watch rank changes.

### Are subcategory products included?

Yes. A category lists every product in it and in its subcategories, as the store does.

### How many products per page?

Up to 60, set with limit; follow page.nextCursor while page.hasMore is true.

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