Sephora
Extract data from Sephora
Extract data from Sephora.
Base URL: /v1/sephora/...
Getting Started
Make your first request to any endpoint below.
3. Read computed fields
When an endpoint supports a computed field and the required source inputs are present, the unified response includes that optional field. Depending on the endpoint, optional fields can include engagement_rate, language, content_category, and estimated_reach. See Computed fields for formulas, clamping rules, and null semantics. Where an endpoint supports them, list rows also carry judged labels (computed.labels, computed.relevance) by default at no extra credits; see Labels.
Endpoints
11 endpoints available.
| Endpoint | Path | Credit Tier |
|---|---|---|
| List Sephora brands | /v1/sephora/brands | standard (1cr) |
| List Sephora root categories | /v1/sephora/categories | standard (1cr) |
| Get a Sephora category and its children | /v1/sephora/category/data | standard (1cr) |
| Get Sephora search suggestions | /v1/sephora/search/suggestions | standard (1cr) |
| Find Sephora stores near a coordinate | /v1/sephora/stores | standard (1cr) |
| Get Sephora in-store availability for a sku | /v1/sephora/availability | advanced (5cr) |
| List Sephora products for a brand | /v1/sephora/brand/products | advanced (5cr) |
| Browse Sephora products in a category | /v1/sephora/category | advanced (5cr) |
| Get a Sephora product by id or URL | /v1/sephora/product | advanced (5cr) |
| Get Sephora product reviews | /v1/sephora/reviews | advanced (5-9cr)metered |
| Search Sephora products by keyword | /v1/sephora/search | advanced (5cr) |
Labels
/v1/sephora/reviews labels each review by default, at no extra credit: sentiment (read from the words, never the stars, with rating_mismatch when the two clearly disagree) and issue (the main problem the review reports) on computed.labels. Send judgments=off for the page without them. See Labels for the field shapes and the labels you can add with label=, such as label=reports&reports=the battery drains quickly.
Notes
- All endpoints use
GETmethod with query parameters - Authentication via
x-api-keyheader - Responses follow the unified SocialCrawl schema