Sephora

List Sephora stores

List Sephora stores in the United States and Canada, by country or state.

GET/v1/sephora/stores
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
countrystringquery

Only stores in this country: `US` or `CA`. Default: both.

one of: US, CA

regionstringquery

Only stores in this state or province, by code (`CA`, `ON`) or name (`California`, `Ontario`), as `/v1/sephora/store` gives it. Case does not matter.

min 2 chars · max 60 chars

limitintegerquery

Stores per page, 1 to 500. Default: 100.

≥ 1 · ≤ 500

cursorstringquery

Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters.

min 1 chars · max 1024 chars

Response fields
20

Endpoint-specific response payload.

datalookupStatus
string

Always `found`: no store in a region is an empty list.

one of: found, not_found

datatotalResults
integer

Stores matching the filters, across every page.

Stores on this page.

datastores[]slug
string

Store slug, e.g. `centerra`.

datastores[]name
stringnullable

Store name.

datastores[]url
string

Store page URL.

datastores[]country
stringnullable

Country code, `US` or `CA`.

datastores[]region
stringnullable

State or province code, e.g. `CO`, as `/v1/sephora/store` gives it.

datastores[]regionName
stringnullable

State or province name, e.g. `Colorado`.

datastores[]isInsideKohls
boolean

Whether it is a Sephora shop inside a Kohl's store.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor for the next page; null on the last page.

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/stores?country=US" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Sephora stores.