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

---

# Sephora Search Suggestions API

See what Sephora suggests as a shopper types: searches, categories and products.

`GET /v1/sephora/search/suggestions?query=lip` returns `data.suggestions` (searches the box offers), `data.categories` (with `id`, `name` and `url`) and `data.products` (product cards with prices and ratings). It is one request per piece of text, the way the store's search box asks while you type.

## Request

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

## FAQ

### What is this useful for?

Keyword research and demand signals: which searches and categories Sephora suggests for a prefix, and which products it puts first.

### How short can the query be?

From one character up to 100. Suggestions are most useful from two or three characters.

### What if nothing matches?

It returns lookupStatus: found with empty suggestions and categories; products may still hold close matches.

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