Sephora Search Suggestions API
See what Sephora suggests as a shopper types: searches, categories and products.
GET /v1/sephora/search/suggestions1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
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.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Sephora Search Suggestions API 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.
Other Sephora endpoints
- ProductGET /v1/sephora/product
- Product reviewsGET /v1/sephora/product/reviews
- Product questionsGET /v1/sephora/product/questions
- SearchGET /v1/sephora/search
- CategoriesGET /v1/sephora/categories
- CategoryGET /v1/sephora/category
- Category productsGET /v1/sephora/category/products
- BrandsGET /v1/sephora/brands