Sephora

List Sephora product questions

List shopper questions about a Sephora product with their answers.

GET/v1/sephora/product/questions
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
productIdstringrequiredquery

Sephora product id (`P442563`) or product page URL (`https://www.sephora.com/product/aha-30-bha-2-peeling-solution-P442563`).

min 1 chars · max 500 chars

sortstringoptionalquery

Order of the questions: `newest` (default), `oldest`, `most_answered` or `recently_answered`.

one of: newest, oldest, most_answered, recently_answered

limitintegeroptionalquery

Questions per page, 1 to 100. Default: 20.

≥ 1 · ≤ 100

cursorstringoptionalquery

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
32

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when Sephora has no product with this id; a product with no questions is `found` with an empty list.

one of: found, not_found

dataproductId
string

The product id asked for.

datatotalResults
integernullable

Questions, across every page.

Questions on this page.

dataquestions[]id
string

Question id.

dataquestions[]productId
stringnullable

Product the question was asked about.

dataquestions[]text
stringnullable

The question.

dataquestions[]details
stringnullable

More detail the asker added; null when the same as `text`.

dataquestions[]submittedAt
stringnullable

When it was asked. ISO 8601 UTC; null when not shown.

dataquestions[]authorNickname
stringnullable

Who asked.

dataquestions[]answerCount
integernullable

Answers it has, on and off this page.

dataquestions[]helpfulCount
integernullable

Readers who found it helpful.

dataquestions[]notHelpfulCount
integernullable

Readers who did not.

Its answers.

dataquestions[]answers[]id
string

Answer id.

dataquestions[]answers[]text
stringnullable

Answer text.

dataquestions[]answers[]submittedAt
stringnullable

When it was posted. ISO 8601 UTC; null when not shown.

dataquestions[]answers[]authorNickname
stringnullable

Who answered.

dataquestions[]answers[]isBrandAnswer
booleannullable

Whether the brand answered.

dataquestions[]answers[]isBestAnswer
booleannullable

Whether it is marked the best answer.

dataquestions[]answers[]helpfulCount
integernullable

Readers who found it helpful.

dataquestions[]answers[]notHelpfulCount
integernullable

Readers who did not.

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/product/questions?productId=P442563" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Sephora product questions.