Sephora API. Products, reviews and stores as JSON.
Look up any product with every shade and price, page through its reviews and questions, search and browse the catalogue by category or brand, and list the stores. Every response uses the same envelope.
- Products + prices
- Reviews and Q&A
- 1 credit per request
- Failed requests aren't charged
Teams running monitoring, research, and enrichment pipelines
Why Social Fetch
Sephora data as JSON. You build the product.
Live Sephora data in one response shape, with platform changes handled for you.
Sephora, plus every other platform
One key and one response envelope for Sephora and 86 more platforms.
API key
sk_live_••••••••
Pricing you can reason about
One request, one credit. Know how far your balance will go before you run your next batch.
- Requests
- 480
- Credits
- 480
Balance
Live data on every request
Fetch public data when you ask for it.
Nothing to maintain
We handle platform changes and breakages.
Built for production jobs
Run concurrent workloads with explicit statuses and request IDs.
lookupStatus: found
Regular jobs. Better rates.
Running lookups every month? Get lower per-credit rates with a monthly plan. For occasional projects, choose pay as you go.
What Sephora data can you get?
12 endpoints, one API key. Every response comes back as live JSON in the same envelope.
Products
Search
Categories
Brands
Stores
Browse all 12 Sephora endpoints
Products
Search
Categories
Brands
Stores
Example request
GET /v1/sephora/product. Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
What teams build with Sephora data
Monitoring, enrichment, research and content workflows on Sephora data, on the same API as every other platform.
How it works
Your first request in three steps.
Use TypeScript or your automation tool of choice.
API key
sfk_live_••••••••••••
Free requests100
Step 1: Create your free account
Get an API key with 100 requests included.
GET/v2/instagram/profiles/charlidamelio
1 request · 1 credit
Step 2: Choose an endpoint
Pass a username, URL, keyword, or post ID.
200 OK1.82s
{
"handle": "charlidamelio",
"displayName": "Charli D'Amelio",
"followers": 48300000,
"following": 1284
}
Step 3: Get clean JSON
Use the response immediately or send it into your pipeline.
Works with your stack
Code, automate, or connect your AI.
Pricing
Social data, priced simply.
Start with 100 free credits. Monthly plans give you predictable volume and lower per-request rates.
Starter
18,000credits
$1.61 per 1k · $0.00161 per request
- Top up from $1.61 / 1k if you run out
- Up to 25 monitors
Growth
50,000credits
$1.58 per 1k · $0.00158 per request
- Top up from $1.58 / 1k if you run out
- 5 team seats
- Up to 100 monitors
Scale
150,000credits
$1.50 per 1k · $0.00150 per request
- Top up from $1.50 / 1k if you run out
- 25 team seats
- Up to 250 monitors
- Cancel anytime
- 30-day money-back guarantee
- Price locked while you stay
Need 1M+ credits, invoicing, or volume rates? Talk to us
Trust signals
DevHunt
Product Hunt
Uneed
Customers
Teams building on Social Fetch.
“Our TikTok and Instagram scrapers broke constantly. Social Fetch took us off that rotation — we ship product again.”
“A maker pastes one link and Social Fetch fills in their bio and socials. Most of inko runs on it, and it just works.”
Jade P. · Founder, inko “Live profile data on every request. We never flag accounts from a stale cache.”
Hannah Webb · Founder, Scam Finder “Heavy concurrent load, no rate limits to negotiate. The rare API I haven't wrapped in retries.”
Owen Pritchard · Founder, IP Flare
Sephora API: common questions
What Sephora data can I get from the API?
Products with every shade and size, prices, stock flags and ingredients; product reviews with statistics; shopper questions and answers; keyword search and search suggestions; the category tree, single categories and category products; every brand and a brand's products; and US and Canadian stores with addresses, coordinates and hours.
How do I name a Sephora product?
Use its product id, such as P442563, or its product page URL. Add skuId to open a particular shade or size. A product Sephora no longer carries returns data.lookupStatus: not_found.
Are prices in the response numbers?
Yes. price, listPrice, salePrice and valuePrice are numbers in the product's currency (USD). salePrice is null unless the sku is on sale; priceText keeps the price as the site writes it.
How do I get every review of a product?
Call /v1/sephora/product/reviews with limit up to 100 and follow page.nextCursor while page.hasMore is true. Each page is one request. Filter by star rating with rating and order with sort.
Can I list a brand's whole catalogue?
Yes. /v1/sephora/brand/products takes the brand's name in any case, its slug or its page URL, and pages through every product with prices and ratings. /v1/sephora/brands lists every brand with its product count.
Can I find stores near a location?
/v1/sephora/stores lists stores by country and state, including Sephora shops inside Kohl's, and /v1/sephora/store returns each store's coordinates, so you can compute distances yourself. A search by coordinates is not offered yet.
Is a search with no match an error?
No. Search returns lookupStatus: found. The store also returns its closest products for words it doesn't recognise, so check totalResults and the products themselves.
How much does the Sephora API cost?
Every Sephora route charges a flat amount per completed request, shown on each endpoint page, and each page of a list is billed separately. A found, empty or not-found answer is a completed request and costs that amount; invalid requests and errors are free. Check meta.creditsCharged on every response. New accounts start with 100 free credits.
The Sephora API in detailHow the Sephora routes work, what they cost, and how they differ from the official API.
Why teams use Social Fetch for Sephora
GET /v1/sephora/product is the center of the Sephora API. A product carries its brand, category path, rating, review count and loves, the plain-text description, usage and ingredients, and skus: every shade and size with its price, list price, sale price, images, stock flags and attributes such as skin type or finish. Pass a product id like P442563 or the product page URL.
Around it, /v1/sephora/product/reviews and /product/questions page through what shoppers wrote, with review statistics and the reviewer's own skin type and age range. /search, /category/products and /brand/products return the same product cards with prices and ratings, the store's filters with counts, and a cursor. /categories, /category and /brands describe the catalogue, and /stores and /store list every store in the United States and Canada with addresses, coordinates and hours. Every answer is JSON in the { data, meta } envelope with data.lookupStatus; a miss is not_found, not an HTTP error.
How to call the Sephora API
1. Create an API key
Sign up at Social Fetch and copy a key (
sfk_…). New accounts get 100 free credits, enough to try every Sephora route.2. Pick the product, category, brand or store
Use a product id or URL, for example
GET /v1/sephora/product?productId=P442563, a category such ascat150006, a brand such asThe Ordinary, or a store slug such ascenterra. Sendx-api-keyon every request.3. Branch and page
Check
data.lookupStatusbefore you store a row. Keep requesting withpage.nextCursorwhilepage.hasMoreis true, and bill frommeta.creditsCharged.
What each Sephora route returns
- Product detail with every shade and size, prices, sale and value prices, images, stock and delivery flags, ingredients and highlights.
- Product reviews with ratings, reviewer attributes, photos, helpful votes and brand replies, plus rating distribution and averages.
- Shopper questions with their answers, including answers from the brand.
- Keyword search and search suggestions, with prices, ratings and the store's filters.
- The category tree, one category with its parents and children, and every product in a category.
- Every brand with product counts, a brand's products, and US and Canadian stores with hours and coordinates.
How much does the Sephora API cost?
Each Sephora route charges a flat credit amount per completed request, shown on every endpoint page. Each page of a list is its own request. Credits never expire on pay-as-you-go packs, and meta.creditsCharged on every response is the billing source of truth.
Social Fetch vs the official Sephora API
Sephora offers no public developer API for its catalogue. Social Fetch gives every route one JSON shape: prices as numbers with a currency, plain text instead of page markup, ISO 8601 UTC dates, typed lookupStatus answers and opaque cursors that continue the same list and filters. You do not need an account or a session.
Pull your first Sephora data.
Run a live Sephora request in the playground. 100 free credits, no card, JSON back in seconds.
No credit cardSign up in 30 seconds withGoogleGitHub