# Changelog of Sephora Product Catalog Scraper — Brands, Categories & Filters (`sian.agency/best-sephora-product-catalog-extractor`) Actor

- **URL**: https://apify.com/sian.agency/best-sephora-product-catalog-extractor/changelog.md
- **Full Actor documentation**: https://apify.com/sian.agency/best-sephora-product-catalog-extractor.md

## Changelog

All notable changes to Sephora Product Search Extractor will be documented in this file.

### \[1.1.0] - 2026-05-24

#### 📂 Category picker expanded — 13 → 293 categories

#### Added

- 📂 **280 new categories** in the picker — drill from top-level "Makeup" all the way down to "Makeup › Eye › Eyeshadow › Eyeshadow Palettes", "Skincare › Treatments › Anti-Aging", and 278 more
- 🍞 **Breadcrumb labels** in the dropdown — every category shows its full path so you always know which one you're picking
- 🎯 Drill into a specific niche (e.g. "Hair › Hair Styling Products › Hair Spray") instead of pulling the whole Hair category

#### Changed

- 📂 Category picker switched from 13 top-level entries to the full 293-category Sephora taxonomy

#### Fixed

- 🔧 A default brand (NARS) is now pre-selected so one-click and automated runs always start with a valid search criterion

### \[1.0.0] - 2026-05-23

#### 🎉 Major release — 341 brands, faster runs, refreshed listing

#### Added

- 🎯 **149 new brands** in the picker — NARS, Olaplex, Rare Beauty, Tatcha, Urban Decay, YSL, Sephora Collection, Pat McGrath, COACH, Fig.1, 5 SENS, and 138 more
- 🆔 Brand picker now covers every brand currently listed on sephora.com (341 total, up from 200)

#### Changed

- ⚡ **Faster runs end-to-end** — typical catalog requests now complete in ~5–10 seconds per page
- 🏷️ **Refreshed actor title** — "Sephora Product Catalog Scraper — Brands, Categories & Filters"
- 📝 **Cleaner Apify Store listing** — new description, improved Google Search snippet
- 📖 **README rewritten** — clearer Quick Start, Input Configuration, Output schema, use cases, FAQ

#### Removed

- 🗑️ 8 stale entries from the brand picker (loyalty-program placeholders, brands no longer sold at Sephora)

#### Fixed

- ✅ Runs that selected a brand without explicitly clearing every other field now succeed from the Apify Console UI

### \[Unreleased]

#### Added

- Cross-promotion link to [Sephora Product Information Extractor](https://apify.com/sian.agency/best-sephora-product-information-extractor) for deep-dive product analysis

### \[2026-02-04]

#### 🚀 Initial Release - Sephora Product Catalog Extraction

**Extract comprehensive product data from 200+ Sephora brands with advanced filtering, rich field output, and visual HTML reports.**

#### 🆕 Core Features

- **Brand Selection from 200+ Brands** - Complete Sephora catalog from AAVRANI to Mario Badescu with dropdown selection for easy brand targeting
- **Advanced Product Filtering** - Filter by price range (min/max), minimum customer rating, and 5 sort options (New Arrivals, Best Sellers, Top Rated, Price Low/High)
- **24-Field Product Data Output** - Comprehensive data including product ID, SKU, name, brand, pricing (numeric and formatted), ratings, reviews, images, and product flags
- **Product Flag Detection** - Automatic detection of Bestseller, New, Sephora Exclusive, Limited Edition, Natural, and Organic product flags
- **Bulk Brand Processing** - Extract multiple brands in a single run with sequential processing to avoid collisions
- **HTML Report Generation** - Visual reports with SVG pie charts showing rating distribution and price categories per brand
- **Flexible Pagination** - Control page size (1-200) and navigate through large catalogs with currentPage parameter
- **Rich Metadata Output** - Shipping eligibility (home, pickup, same-day), stock status, and ISO timestamps for all records

#### 💎 User Benefits

- **Market Research at Scale** - Analyze product trends across 200+ beauty brands with ratings, reviews, and pricing data in one extraction
- **Competitor Price Monitoring** - Track competitor pricing in real-time with price range filtering and numeric price fields for analysis
- **Product Sourcing Automation** - Build or sync e-commerce catalogs automatically with complete product records including images and URLs
- **Trend Analysis Across Brands** - Identify bestsellers, new launches, and top-rated products across multiple brands simultaneously
- **Catalog Synchronization** - Keep product databases up-to-date with scheduled runs and 24-field structured output
- **Visual Reporting** - HTML reports with SVG pie charts for presentations to stakeholders and quick visual analysis

#### 🎯 Use Cases

- **Beauty Brands** - Monitor competitor products, track pricing strategies, identify market gaps, analyze product performance
- **E-commerce Retailers** - Source products for dropshipping, sync catalogs across channels, build recommendation engines
- **Market Researchers** - Analyze beauty industry trends, track new product launches, measure brand performance
- **Price Intelligence Teams** - Monitor competitor pricing, track price changes, identify pricing opportunities
- **Product Sourcing Professionals** - Find products for online stores, compare across brands, identify high-demand items
- **Beauty Bloggers & Influencers** - Discover trending products, find top-rated items for reviews, track new launches

#### 💰 Tier-Based Pricing

**FREE Tier:**

- 10 products total for testing
- Full feature access (same data quality as PAID)
- No credit card required
- Perfect for evaluation and small projects

**PAID Tier:**

- Unlimited products
- Unlimited concurrent runs
- Priority processing
- Production-ready scalability for large catalogs

#### 📊 What You Get

Each product record includes 24 fields:

- **Identity**: productId, skuId, brandId, brandName, productName, displayName
- **URLs**: targetUrl (direct product page link)
- **Images**: heroImage, altImage (high-resolution product images)
- **Pricing**: listPrice (formatted), priceNumeric (for calculations), onSaleData
- **Ratings**: rating (formatted), ratingNumeric, reviews, reviewsCount
- **Shipping**: shipToHomeEligible, pickupEligible, sameDayEligible
- **Flags**: isBestseller, isNew, isSephoraExclusive, isLimitedEdition, isNatural, isOrganic
- **Metadata**: itemType, processedAt (ISO timestamp)

**Event Charges:**

- `apify-actor-start` - Charged per run (developer pricing eligible)
- `sephora-product-extracted` - Charged per product extracted