List Sephora stores
List Sephora stores in the United States and Canada, by country or state.
Headers
Get your API keyAPI key (`sfk_...`)
Only stores in this country: `US` or `CA`. Default: both.
one of: US, CA
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
Stores per page, 1 to 500. Default: 100.
≥ 1 · ≤ 500
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
Endpoint-specific response payload.
Always `found`: no store in a region is an empty list.
one of: found, not_found
Stores matching the filters, across every page.
Stores on this page.
Store slug, e.g. `centerra`.
Store name.
Store page URL.
Country code, `US` or `CA`.
State or province code, e.g. `CO`, as `/v1/sephora/store` gives it.
State or province name, e.g. `Colorado`.
Whether it is a Sephora shop inside a Kohl's store.
Pagination state for the current page.
Whether another page is available.
Cursor for the next page; null on the last page.
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/stores?country=US" \
-H "x-api-key: YOUR_API_KEY"Responses
Sephora stores.