Sephora Product Scraper

Scrape the full Sephora product catalog across 14 storefronts (US, AU, NZ, SG, MY, ID, TH, PH, MX, DE, RO, SE, GR, DK) with one unified output schema. Pull brand, title, ingredients, claims, full variant matrix with shades and SKUs, ratings histogram, top reviews, top Q&A, and rich media in a single dataset that drops cleanly into BI, ETL, or comparison tooling.

Why this scraper

• 14 regional storefronts under one input form, no per-region forking
• 80+ fields per product: variants (every shade, size, SKU, UPC), options, ingredients, claims, awards, ratings histogram, secondary ratings, sentiment tags, top reviews, top Q&A
• Search by keyword, by category slug, or paste any Sephora URL (product, category, brand, search) and the scraper auto-detects the storefront
• Cross-region market field (sea-au, sea-nz, americas-us, europe-de, ...) so multi-market analytics work out of the box
• Forward-paginated walks with checkpoint resume; pulls 24-60 fully-attributed products per search request

Storefronts

Region	Storefronts
Americas	us (sephora.com), mx (sephora.com.mx)
APAC	com.au (sephora.com.au), nz (sephora.nz), sg (sephora.sg), my (sephora.my), id (sephora.co.id), th (sephora.co.th), ph (sephora.ph)
Europe	de (sephora.de), ro (sephora.ro), se (sephora.se), gr (sephora.gr), dk (sephora.dk)

Data you get

Sample shape, values are illustrative placeholders, not from a live listing.

Field	Example
market	sea-nz
source.id	00000001
source.canonicalUrl	https://www.sephora.nz/products/sample-foundation
source.retailer	SEPHORA
source.currency	NZD
source.locale	en-NZ
brand	Sample Brand
title	Sample Foundation
subtitle	30ml
description	" A self-priming foundation, primes, covers and sets... "
ingredients	"Aqua, Cyclopentasiloxane, Glycerin, ..."
howToUse	"Shake well. Apply a small amount onto the back of your hand and use a brush..."
claims	["Cruelty free", "Paraben free", "Vegan"]
currentSku	0000000
categories	["Makeup", "Face", "Foundation"]
options[].name	shade
options[].values[].value	1 Fair Neutral
variants[].sku	0000000
variants[].shade	1 Fair Neutral
variants[].price.current	77.0
variants[].price.original	77.0
variants[].price.stockStatus	IN_STOCK
variants[].swatchUrl	https://image-optimizer.example.com/swatches/icon_swatch_0000.png
variants[].imageUrl	https://image-optimizer.example.com/products/sample.jpg
variants[].inventory	13
medias[].url	https://image-optimizer.example.com/products/sample-zoom.jpg
medias[].type	image
medias[].role	hero
stats.rating	4.8
stats.reviewCount	971
stats.recommendedCount	800
ratingHistogram	[{"RatingValue": 5, "Count": 700}, ...]
secondaryRatings	{"Quality": {"AverageRating": 4.8}}
sentiments	{"Pros": [{"Value": "Long-lasting", "Count": 300}]}
topReviews[].rating	5
topReviews[].title	"Best foundation I have ever tried"
topReviews[].body	"Sample review text appears here..."
topReviews[].skinType	combination
topReviews[].skinTone	fair
topReviews[].publishedAt	2026-01-01T00:00:00.000Z
topQuestions[].question	Is this product fragrance free?
isNewArrival	false
underSale	false
highlights	["NEW", "Only at Sephora"]
articles[].type	how-to
frontend	sea
scrapedAt	2026-01-01T00:00:00.000Z

How to use

Search by keyword

{
  "mode": "search",
  "storefront": "nz",
  "queries": ["foundation", "mascara"],
  "maxPages": 5,
  "maxProducts": 100,
  "fetchDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "NZ"
  }
}

Search by category

{
  "mode": "search",
  "storefront": "us",
  "categories": ["shop/makeup-cosmetics", "shop/skincare"],
  "ratingMin": 4,
  "maxPages": 3,
  "maxProducts": 60,
  "fetchDetails": true,
  "fetchReviews": true,
  "maxReviewsPerProduct": 10,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}

URL mode (single product)

{
  "mode": "url",
  "urls": [
    "https://www.sephora.nz/products/rare-beauty-true-to-myself-natural-matte-longwear-foundation"
  ],
  "fetchDetails": true,
  "fetchReviews": true,
  "fetchQna": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "NZ"
  }
}

URL mode (multiple regions in one run)

{
  "mode": "url",
  "urls": [
    "https://www.sephora.nz/search?keyword=mascara",
    "https://www.sephora.com.au/search?keyword=mascara",
    "https://www.sephora.fr/recherche?q=mascara"
  ],
  "maxPages": 2,
  "maxProducts": 30,
  "fetchDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Input parameters

Parameter	Type	Default	Description
mode	enum	search	"search" or "url"
storefront	enum	us	One of 21+ regional sites; only used in search mode
queries	string[]	["foundation"]	Keywords to search; one search per query
categories	string[]	[]	Category slugs from the storefront's nav
brands	string[]	[]	Brand slugs to filter results client-side
priceMin	int	unset	Minimum product price in storefront currency
priceMax	int	unset	Maximum product price in storefront currency
ratingMin	enum	0	Minimum average rating (0/3/4/5)
sortBy	enum	relevance	relevance, popular, rating, price-asc, price-desc, newest
newOnly	bool	false	Only products marked new arrival
exclusiveOnly	bool	false	Only "Only at Sephora" products
urls	string[]	one example	URLs to crawl in URL mode
fetchDetails	bool	false	Pull the full product detail (ingredients, claims, full variant matrix, awards)
fetchReviews	bool	false	Pull top reviews and Bazaarvoice rating histogram
maxReviewsPerProduct	int	10	Cap reviews per product (1-100)
fetchQna	bool	false	Pull top questions and answers
maxQnaPerProduct	int	5	Cap Q&A per product (1-50)
maxPages	int	5	Pages per query / category / URL (1-100)
maxProducts	int	0	Total cap, 0 means unlimited
proxyConfiguration	object	residential US	Proxy block; residential is recommended
resumeFromCheckpoint	bool	true	Resume previous run from KV store checkpoint

Output example

Sample shape, values are illustrative placeholders, not from a live listing.

{
  "market": "sea-nz",
  "source": {
    "id": 0,
    "crawlUrl": "https://www.sephora.nz/products/sample-foundation",
    "canonicalUrl": "https://www.sephora.nz/products/sample-foundation",
    "retailer": "SEPHORA",
    "currency": "NZD",
    "locale": "en-NZ"
  },
  "brand": "Sample Brand",
  "title": "Sample Foundation",
  "subtitle": "30ml",
  "description": "<p>A self-priming foundation, primes, covers and sets...</p>",
  "shortDescription": "<p>3-in-1 foundation primes, covers and sets...</p>",
  "ingredients": "Aqua, Cyclopentasiloxane, Glycerin, ...",
  "howToUse": "Shake well. Apply a small amount onto the back of your hand and use a brush or fingertips to blend onto skin.",
  "claims": ["Cruelty free", "Paraben free", "Vegan"],
  "currentSku": "0000000",
  "categories": ["Makeup", "Face", "Foundation"],
  "options": [
    {
      "name": "shade",
      "id": "0",
      "values": [{ "value": "1 Fair Neutral", "label": "1 Fair Neutral", "id": "0" }]
    }
  ],
  "variants": [
    {
      "id": "0",
      "sku": "0000000",
      "gtin": "000000000000",
      "name": "1 Fair Neutral",
      "shade": "1 Fair Neutral",
      "size": "30ml",
      "price": {
        "current": 77.0,
        "original": 77.0,
        "currency": "NZD",
        "stockStatus": "IN_STOCK",
        "available": true,
        "inventory": 13
      },
      "highlights": ["NEW", "Only at Sephora"],
      "swatchUrl": "https://image-optimizer.example.com/swatches/icon_swatch_0000.png",
      "imageUrl": "https://image-optimizer.example.com/products/sample.jpg"
    }
  ],
  "medias": [
    { "url": "https://image-optimizer.example.com/products/sample-zoom.jpg", "type": "image", "role": "hero" }
  ],
  "stats": {
    "reviewCount": 971,
    "rating": 4.8,
    "recommendedCount": 800,
    "totalPhotoCount": 100
  },
  "ratingHistogram": [
    { "RatingValue": 5, "Count": 700 },
    { "RatingValue": 4, "Count": 200 },
    { "RatingValue": 3, "Count": 50 },
    { "RatingValue": 2, "Count": 15 },
    { "RatingValue": 1, "Count": 6 }
  ],
  "topReviews": [
    {
      "id": "0",
      "rating": 5,
      "title": "Best foundation I have ever tried",
      "body": "Sample review text appears here...",
      "publishedAt": "2026-01-01T00:00:00.000Z",
      "skinType": "combination",
      "skinTone": "fair"
    }
  ],
  "highlights": ["NEW", "Only at Sephora"],
  "frontend": "sea",
  "scrapedAt": "2026-01-01T00:00:00.000Z"
}

Plan requirement

• Free plan: works for AU/NZ/EU storefronts on the default proxy in many cases, may return zero results on the US storefront where residential exits are needed.
• Starter or higher: required for full reliability across all 21+ storefronts. Residential proxy access is included from Starter; pin the country to the storefront's home country (US for sephora.com, NZ for sephora.nz, FR for sephora.fr, etc.) for the most stable runs.
• Choose the matching storefront in the input form (or paste URLs from that storefront in URL mode); the actor follows your input and does not auto-redirect across regions.