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

---

# Sephora Categories API

Read Sephora's category tree, from Makeup and Skincare down to the narrowest subcategory, with product counts.

`GET /v1/sephora/categories` returns the top-level categories in `data.categories`, each with `id`, `name`, `url`, `productCount`, `parentId` and `level`. Add `depth=1` to `depth=3` to include that many levels of subcategories; they are listed parent first, so a category's children follow it. `data.totalProducts` counts the whole store.

## Request

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

## FAQ

### How deep does the tree go?

depth=0 returns the top level only; depth=3 includes three more levels below it. Each row's level and parentId let you rebuild the tree.

### How do I get the products of a category?

Pass its id (for example cat150006) or slug to /v1/sephora/category/products.

### Do the product counts change?

Yes, they follow the store's live catalogue.

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