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

---

# Sephora Category API

Look up one Sephora category and see where it sits: its parents above and every subcategory below.

`GET /v1/sephora/category?category=foundation-makeup` returns `data.category` with `id`, `name`, `url`, `productCount`, `parents` (top level first) and `children`, every subcategory below it, parent first. Pass a category id such as `cat150006`, a category page URL or its slug. An unknown category is `lookupStatus: not_found`.

## Request

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

## FAQ

### Which forms of category can I pass?

A category id such as cat150006, a page URL such as https://www.sephora.com/shop/skincare, or the slug from that URL, such as skincare.

### How are subcategories ordered?

Parent first: each subcategory is followed by its own children, with parentId and level on every row.

### What if the category doesn't exist?

The lookup returns lookupStatus: not_found with category: null.

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