📁 Sephora Category Scraper – Browse Products by Category

💄 Browse Sephora products by category and extract comprehensive product listings with pricing, ratings, images, badges, and more. Supports pagination, price range filtering, sorting options, and detailed beauty product data. Built with Apify best practices for reliability and speed.

---

📋 Table of Contents

• ✨ Features
• 🎯 Use Cases
• ⚡ Quick Start
• 📊 Input Parameters
• 📤 Output Format
• 📈 Performance & Limits
• ❓ FAQ
• 🛠️ Troubleshooting
• 🏷️ Tags

---

✨ Features

• 📁 Category Browsing – Browse Sephora by any category slug (foundation, lipstick, moisturizer, etc.)
• 📄 Pagination Support – Scrape multiple pages of category listings (up to 20 pages)
• 💰 Price Range Filter – Filter products by minimum and maximum price
• 📊 Smart Sorting – Sort by best selling, top rated, new, or price
• 🏅 Rich Metadata – Get badges, ratings, reviews, prices, images, and more
• 💎 Product Badges – Bestseller, Sephora Exclusive, Limited Edition, New, and more
• 📂 Category Info – Get category name and total available products count
• ⚡ Fast & Reliable – Built-in retries, rate-limit handling, and error recovery

---

🎯 Use Cases

Use Case	Description	Key Benefits
📁 Category Analysis	Browse entire Sephora categories to analyze product offerings	Discover full category landscape
💰 Price Monitoring	Track pricing trends within specific product categories	Identify deals, monitor price changes
📊 Market Research	Analyze category-level rankings and product positioning	Market trends, competitive intelligence
🏆 Brand Tracking	Monitor brand presence within Sephora categories	Track rankings, bestseller status
⭐ Review Analysis	Collect ratings and review counts for category products	Sentiment analysis, product comparison
🆕 New Product Discovery	Find newly added products in any category	Stay ahead of trends
🤖 Data Pipelines	Feed structured category data to your systems	Automation, dashboards, ML models

---

⚡ Quick Start

1️⃣ Basic – Browse a Category

{
  "categoryId": "foundation-makeup",
  "maxPages": 1
}

2️⃣ Advanced – Multiple Pages with Sorting

{
  "categoryId": "lipstick",
  "maxPages": 3,
  "pageSize": 30,
  "sortBy": "TOP_RATED"
}

3️⃣ Price Range Filter

{
  "categoryId": "moisturizing-cream-oils-mists",
  "maxPages": 2,
  "sortBy": "PRICE_LOW_TO_HIGH",
  "minPrice": 20,
  "maxPrice": 50
}

4️⃣ Best Selling Products – Large Page Size

{
  "categoryId": "mascara",
  "maxPages": 5,
  "pageSize": 60,
  "sortBy": "BEST_SELLING"
}

---

📊 Input Parameters

Parameter	Type	Required	Description	Default	Example
categoryId	String	✅ Yes	Sephora category slug	-	"foundation-makeup", "lipstick", "mascara"
maxPages	Integer	❌ No	Number of pages to scrape (1-20)	1	3, 5, 10
pageSize	Integer	❌ No	Products per page (1-60)	30	10, 30, 60
sortBy	String	❌ No	Sort order	BEST_SELLING	TOP_RATED, NEW, PRICE_HIGH_TO_LOW
minPrice	Integer	❌ No	Minimum price in $	-	10, 25
maxPrice	Integer	❌ No	Maximum price in $	-	50, 100

🎯 Sort Options

• BEST_SELLING – Most popular products (default)
• TOP_RATED – Highest rated products first
• NEW – Newest arrivals
• PRICE_HIGH_TO_LOW – Most expensive products first
• PRICE_LOW_TO_HIGH – Cheapest products first

📁 Popular Category IDs

Category	categoryId
Foundation	foundation-makeup
Lipstick	lipstick
Mascara	mascara
Concealer	concealer
Face Primer	makeup-primer-face-primer
Moisturizer	moisturizing-cream-oils-mists
Cleanser	cleanser
Sunscreen	sunscreen-sun-protection
Eyeshadow	eyeshadow
Blush	blush
Highlighter	luminizer-luminous-makeup
Setting Spray & Powder	setting-powder-face-powder
Contour	contour-palette-brush
BB & CC Cream	bb-cc-cream-face-makeup
Tinted Moisturizer	tinted-moisturizer
Fragrance	perfume
Hair Shampoo	shampoo-hair

💡 Tip: You can get more category IDs from the Sephora Categories List API endpoint or from Sephora's website URL slugs (e.g., sephora.com/shop/foundation-makeup → foundation-makeup).

---

📤 Output Format

🧾 Category Result Data Structure

{
  "source": "sephora_category",
  "categoryId": "foundation-makeup",
  "categoryName": "Foundation",
  "page": 1,
  "position": 1,
  "productId": "P519887",
  "brandName": "Armani Beauty",
  "displayName": "Luminous Silk Natural Glow Blurring Liquid Foundation with 24 Hour Wear",
  "productUrl": "https://www.sephora.com/product/luminous-silk-natural-glow-blurring-liquid-foundation-with-24-hour-wear-P519887?skuId=2926731",
  "heroImage": "https://www.sephora.com/productimages/sku/s2926731-main-zoom.jpg?imwidth=270",
  "altImage": "https://www.sephora.com/productimages/sku/s2926731-main-zoom.jpg?imwidth=270",
  "listPrice": "$48.00 - $69.00",
  "rating": 4.5364,
  "reviews": 2569,
  "isBestseller": true,
  "isNew": true,
  "isOnlineOnly": false,
  "isSephoraExclusive": false,
  "isLimitedEdition": false,
  "isLimitedTimeOffer": false,
  "isAppExclusive": false,
  "isBI": false,
  "skuId": "2926731",
  "imageAltText": "Armani Beauty - Luminous Silk Natural Glow Blurring Liquid Foundation with 24 Hour Wear",
  "moreColors": 46,
  "onSaleData": "NONE",
  "pickupEligible": false,
  "sameDayEligible": false,
  "shipToHomeEligible": false,
  "sponsored": false,
  "scraped_at": "2026-03-09T02:37:04.972Z"
}

📋 Output Fields Explained

Field	Type	Description
source	String	Always sephora_category
categoryId	String	Category slug used for browsing
categoryName	String	Display name of the category (e.g., "Foundation")
page	Integer	Page number in category results
position	Integer	Position on the page (1-based)
productId	String	Sephora product ID
brandName	String	Brand name (e.g., "DIOR", "Charlotte Tilbury")
displayName	String	Display name shown on Sephora
productUrl	String	Direct product URL on Sephora
heroImage	String	Main product image URL
altImage	String	Alternate product image URL
listPrice	String	Product price (e.g., "$48.00", "$48.00 - $69.00")
rating	Number	Average rating (e.g., 4.54)
reviews	Integer	Total number of reviews
isBestseller	Boolean	Has Bestseller badge
isNew	Boolean	Is a new product
isOnlineOnly	Boolean	Available online only
isSephoraExclusive	Boolean	Sephora exclusive product
isLimitedEdition	Boolean	Limited edition product
isLimitedTimeOffer	Boolean	Limited time offer
isAppExclusive	Boolean	App exclusive product
isBI	Boolean	Beauty Insider exclusive
skuId	String	SKU identifier
imageAltText	String	Image alt text / product description
moreColors	Integer	Number of additional color options
onSaleData	String	Sale status (e.g., "NONE", "SALE")
pickupEligible	Boolean	Available for store pickup
sameDayEligible	Boolean	Eligible for same-day delivery
shipToHomeEligible	Boolean	Eligible for home shipping
sponsored	Boolean	Sponsored/promoted product
scraped_at	String	ISO 8601 timestamp of when data was scraped

---

📈 Performance & Limits

Metric	Value
⏱️ Average speed	~2-3 seconds per page
📄 Max pages per run	20
📦 Products per page	Up to 60
🔄 Max products per run	~1,200 (20 pages × 60 products)
⏳ Delay between pages	1.5 seconds (built-in)
🔁 Auto-retry	Yes (on 500/502/503/504/429 errors)

---

❓ FAQ

• Q: What input do I need?

  • Just a category ID (e.g., "foundation-makeup"). All other parameters are optional.

• Q: How do I find category IDs?

  • Use the Sephora website URL pattern: sephora.com/shop/{categoryId}. For example, sephora.com/shop/foundation-makeup → categoryId = "foundation-makeup". You can also use the Sephora Categories List API endpoint.

• Q: How many pages can I scrape?

  • Up to 20 pages per run. Each page can return up to 60 products.

• Q: How do I sort results?

  • Use sortBy parameter: BEST_SELLING, TOP_RATED, NEW, PRICE_HIGH_TO_LOW, or PRICE_LOW_TO_HIGH.

• Q: Can I filter by price range?

  • Yes! Use minPrice and maxPrice parameters to set a price range in dollars.

• Q: What if no results are found?

  • The actor will stop pagination and report the issue. Try a different category ID or adjust filters.

• Q: What badges are tracked?

  • Bestseller, New, Sephora Exclusive, Limited Edition, Limited Time Offer, App Exclusive, Beauty Insider, and Online Only.

• Q: Does it show the total number of products in a category?

  • Yes! The actor logs the total available products count when the first page is fetched.

---

🛠️ Troubleshooting

Issue	Cause	Solution
❌ "No category ID provided"	Empty or missing categoryId	Provide a valid category ID (e.g., foundation-makeup)
⚠️ "No results found"	Invalid category ID or filters too strict	Check category slug from Sephora website URL
⏱️ Slow runs	Many pages or large page size	Reduce maxPages or pageSize
🔄 Pagination stopped early	No more results available	Normal behavior - all results scraped
❌ Server error (500)	Temporary API issue	Actor auto-retries with backoff

---

🏆 Why Choose This Actor?

✅ Browse entire Sephora categories with pagination
✅ Price range filtering for budget-focused research
✅ Rich product metadata with 8+ badge types
✅ Category name and total product count
✅ Track category rankings and positions
✅ Fast, reliable, and structured data
✅ Auto-retry on server errors

---

🏷️ Tags

sephora scraper, sephora category scraper, sephora category api, sephora browse by category, sephora product listings, sephora category extractor, sephora price tracker, sephora beauty products, sephora ratings scraper, sephora bestsellers, sephora product data, sephora product research, beauty product scraper, cosmetics scraper, makeup product data, skincare product search, beauty brand tracker, sephora competitive analysis, apify actor, sephora category automation

---

🚀 Get Started Now

Ready to browse Sephora categories?

1. 📁 Enter the category ID (e.g., foundation-makeup)
2. ⚙️ Set the maximum pages to scrape (1-20)
3. 🎛️ Optionally configure filters (price range, sort order)
4. ▶️ Click Start to run the actor
5. 📥 Download your data in JSON, CSV, Excel, or HTML format
6. 📊 Use the built-in table views to browse products, prices, and ratings
7. Click "Try for free" to test the actor

⭐ If this actor helps your workflow, please give it a star!

Related Actors 🤝

• Sephora Search Scraper – Search Sephora products by keyword
• Amazon Search Scraper – Search Amazon products by keyword

Built with ❤️ using Apify Platform | Optimized for Performance & Reliability