🔍 Sephora Search Scraper – Search Results Extractor

💄 Search Sephora products by keyword and extract comprehensive search results with pricing, ratings, images, badges, and more. Supports pagination, advanced 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

• 🔎 Keyword Search – Search Sephora by any keyword or phrase
• 📄 Pagination Support – Scrape multiple pages of search results (up to 20 pages)
• 🎯 Advanced Filtering – Filter by rating, price range, category, and new products
• 📊 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
• ⚡ Fast & Reliable – Built-in retries, rate-limit handling, and error recovery

---

🎯 Use Cases

Use Case	Description	Key Benefits
🔍 Product Research	Discover beauty products by keyword across categories	Find trending items, analyze competition
💰 Price Monitoring	Track pricing trends for specific beauty products	Identify deals, monitor price changes
📊 Market Analysis	Analyze search rankings and product positioning	SEO insights, market trends
🏆 Brand Tracking	Monitor brand products in Sephora search results	Track rankings, bestseller status
⭐ Review Analysis	Collect ratings and review counts for beauty products	Sentiment analysis, product comparison
🤖 Data Pipelines	Feed structured search data to your systems	Automation, dashboards, ML models

---

⚡ Quick Start

1️⃣ Basic – Simple Search

{
  "keyword": "lipstick",
  "maxPages": 1
}

2️⃣ Advanced – Multiple Pages with Filters

{
  "keyword": "moisturizer",
  "maxPages": 3,
  "pageSize": 30,
  "sortBy": "TOP_RATED",
  "minRating": 4
}

3️⃣ Price Range Search

{
  "keyword": "foundation",
  "maxPages": 2,
  "sortBy": "PRICE_LOW_TO_HIGH",
  "minPrice": 20,
  "maxPrice": 50
}

4️⃣ New Products Only

{
  "keyword": "serum",
  "maxPages": 1,
  "sortBy": "NEW",
  "isNew": "true"
}

---

📊 Input Parameters

Parameter	Type	Required	Description	Default	Example
keyword	String	✅ Yes	Search keyword or phrase	-	"lipstick", "moisturizer", "foundation"
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
minRating	Integer	❌ No	Minimum rating filter (1-5)	-	4, 3
minPrice	Integer	❌ No	Minimum price in $	-	10, 25
maxPrice	Integer	❌ No	Maximum price in $	-	50, 100
categoryId	String	❌ No	Filter by category ID	-	Get from Sephora Categories endpoint
isNew	String	❌ No	Filter for new products	-	"true", "false"

🎯 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

---

📤 Output Format

🧾 Search Result Data Structure

{
  "source": "sephora_search",
  "search_keyword": "lipstick",
  "page": 1,
  "position": 1,
  "productId": "P501496",
  "brandName": "SEPHORA COLLECTION",
  "productName": "Satin Hydrating Lipstick",
  "displayName": "Satin Hydrating Lipstick",
  "productUrl": "https://www.sephora.com/product/satin-hydrating-lipstick-P501496?skuId=2564474",
  "apiUrl": "https://www.sephora.com/api/catalog/products/P501496?preferedSku=2564474",
  "heroImage": "https://www.sephora.com/productimages/sku/s2564474-main-zoom.jpg?imwidth=270",
  "image135": "https://www.sephora.com/productimages/sku/s2564474-main-zoom.jpg?imwidth=270",
  "image250": "https://www.sephora.com/productimages/sku/s2564474-main-zoom.jpg?imwidth=270",
  "image450": "https://www.sephora.com/productimages/sku/s2564474-main-zoom.jpg?imwidth=270",
  "altImage": "https://www.sephora.com/productimages/sku/s2564474-main-zoom.jpg?imwidth=270",
  "listPrice": "$16.00",
  "rating": 4.4885,
  "reviews": 348,
  "isBestseller": true,
  "isNew": false,
  "isOnlineOnly": false,
  "isSephoraExclusive": false,
  "isLimitedEdition": false,
  "isLimitedTimeOffer": false,
  "isAppExclusive": false,
  "isBI": false,
  "skuId": "2564474",
  "imageAltText": "SEPHORA COLLECTION - Satin Hydrating Lipstick",
  "moreColors": 16,
  "onSaleData": "NONE",
  "pickupEligible": false,
  "sameDayEligible": false,
  "shipToHomeEligible": false,
  "sponsored": false,
  "scraped_at": "2026-03-08T02:57:58.301Z"
}

📋 Output Fields Explained

Field	Type	Description
source	String	Always sephora_search
search_keyword	String	Original search keyword
page	Integer	Page number in search results
position	Integer	Position on the page (1-based)
productId	String	Sephora product ID
brandName	String	Brand name (e.g., "DIOR", "Charlotte Tilbury")
productName	String	Product name
displayName	String	Display name shown on Sephora
productUrl	String	Direct product URL on Sephora
apiUrl	String	Sephora API URL for product details
heroImage	String	Main product image URL
image135	String	135px product image URL
image250	String	250px product image URL
image450	String	450px product image URL
altImage	String	Alternate product image URL
listPrice	String	Product price (e.g., "$26.00")
rating	Number	Average rating (e.g., 4.49)
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 search keyword (e.g., "lipstick"). All other parameters are optional.

• 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: Can I filter by rating?

  • Yes! Use minRating parameter to set minimum rating (1-5).

• Q: How do I find only new products?

  • Set isNew to "true" and optionally use sortBy: "NEW".

• Q: What if no results are found?

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

• Q: What badges are tracked?

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

---

🛠️ Troubleshooting

Issue	Cause	Solution
❌ "No search keyword provided"	Empty or missing keyword	Provide a valid search keyword
⚠️ "No results found"	Invalid keyword or filters too strict	Try broader search terms or remove filters
⏱️ 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?

✅ Keyword-based beauty product search with pagination
✅ Advanced filtering by price, rating, category & more
✅ Rich product metadata with 8+ badge types
✅ Multiple image sizes for each product
✅ Track search rankings and positions
✅ Fast, reliable, and structured data
✅ Auto-retry on server errors

---

🏷️ Tags

sephora scraper, sephora product search, sephora search api, sephora keyword search, sephora search results extractor, sephora product finder, 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 search automation

---

🚀 Get Started Now

Ready to scrape Sephora search results?

1. 🎯 Enter the search keyword (e.g., lipstick)
2. ⚙️ Set the maximum pages to scrape (1-20)
3. 🎛️ Optionally configure filters (rating, price, sort)
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 🤝

• Amazon Search Scraper

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