Sephora

List Sephora search suggestions

List the searches, categories and products Sephora suggests for partly typed text.

GET/v1/sephora/search/suggestions
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
querystringrequiredquery

What the shopper has typed so far, up to 100 characters (`lip`).

min 1 chars · max 100 chars

Response fields
39

Endpoint-specific response payload.

datalookupStatus
string

Always `found`: no suggestion is an empty list.

one of: found, not_found

dataquery
string

The text the suggestions are for.

Searches the site suggests completing to.

datasuggestions[]
stringoptional

Categories the site suggests.

datacategories[]id
string

Category id, e.g. `cat150006`.

datacategories[]name
stringnullable

Category name.

datacategories[]url
stringnullable

Category page URL; null when not shown.

Products the site suggests.

dataproducts[]id
string

Product id, e.g. `P442563`.

dataproducts[]name
stringnullable

Product name.

dataproducts[]brand
stringnullable

Brand name.

dataproducts[]url
stringnullable

Product page URL.

dataproducts[]skuId
stringnullable

Id of the shade or size the card shows.

dataproducts[]imageUrl
stringnullable

Product image URL.

dataproducts[]description
stringnullable

Short description the card shows.

dataproducts[]rating
numbernullable

Average star rating out of 5; null with no reviews.

dataproducts[]reviewCount
integernullable

Number of reviews.

dataproducts[]price
numbernullable

Price the shopper pays now, in `currency`.

dataproducts[]listPrice
numbernullable

Regular price before any sale, in `currency`.

dataproducts[]valuePrice
numbernullable

Stated value of a set or kit; null when none is shown.

dataproducts[]currency
string

Currency code, e.g. `USD`.

dataproducts[]size
stringnullable

Size, e.g. `1 oz/ 30 mL`.

dataproducts[]variationType
stringnullable

What the variants differ by: `Color`, `Size` or `None`.

dataproducts[]variationValue
stringnullable

The shown variant's shade or size.

dataproducts[]variantCount
integernullable

Number of shades or sizes.

dataproducts[]isOnSale
booleannullable

Whether it is on sale.

dataproducts[]isNew
booleannullable

Whether Sephora marks it new.

dataproducts[]isBestseller
booleannullable

Whether Sephora marks it a bestseller.

dataproducts[]isLimitedEdition
booleannullable

Whether it is a limited edition.

dataproducts[]isOnlineOnly
booleannullable

Whether it is sold online only.

dataproducts[]isSephoraExclusive
booleannullable

Whether it is a Sephora exclusive.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.