List Sephora search suggestions
List the searches, categories and products Sephora suggests for partly typed text.
Headers
Get your API keyAPI key (`sfk_...`)
What the shopper has typed so far, up to 100 characters (`lip`).
min 1 chars · max 100 chars
Endpoint-specific response payload.
Always `found`: no suggestion is an empty list.
one of: found, not_found
The text the suggestions are for.
Searches the site suggests completing to.
Categories the site suggests.
Category id, e.g. `cat150006`.
Category name.
Category page URL; null when not shown.
Products the site suggests.
Product id, e.g. `P442563`.
Product name.
Brand name.
Product page URL.
Id of the shade or size the card shows.
Product image URL.
Short description the card shows.
Average star rating out of 5; null with no reviews.
Number of reviews.
Price the shopper pays now, in `currency`.
Regular price before any sale, in `currency`.
Stated value of a set or kit; null when none is shown.
Currency code, e.g. `USD`.
Size, e.g. `1 oz/ 30 mL`.
What the variants differ by: `Color`, `Size` or `None`.
The shown variant's shade or size.
Number of shades or sizes.
Whether it is on sale.
Whether Sephora marks it new.
Whether Sephora marks it a bestseller.
Whether it is a limited edition.
Whether it is sold online only.
Whether it is a Sephora exclusive.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/sephora/search/suggestions?query=lip" \
-H "x-api-key: YOUR_API_KEY"Responses
Sephora search suggestions.