Sephora Master Scraper

A high-performance, production-ready Sephora scraper for extracting product data, search results, and verified customer reviews from Sephora and Bazaarvoice APIs.

This actor supports 4 powerful scraping modes:

• Product search scraping (keyword-based)
• Direct product URL scraping
• Product reviews extraction (Bazaarvoice API)
• Questions and answers

Built for scalability, pagination handling, and real-world e-commerce data extraction.

---

🚀 Features

• 🔍 Search Mode – scrape Sephora search results by keyword
• 🔗 Direct URL Mode – extract full product details from PDP pages
• 💬 Reviews Mode – collect all customer reviews via Bazaarvoice API
• 💬 Questions and answers Mode – collect all customer questions and answers
• 📄 Automatic pagination handling
• ⚡ High-speed scraping with got-scraping
• 💎 Free vs Paid user limits support
• 📦 Structured JSON output
• 🔁 Safe retry-ready architecture

---

🧠 Modes Overview

1. SEARCH MODE (Keyword Scraping)

Extract products from Sephora search results.

{
  "mode": "SEARCH",
  "queries": ["lipstick", "foundation"],
  "maxItems": 100
}

✔ Supports pagination ✔ Returns product listings ✔ Fast keyword-based discovery

---

2. DIRECT_URLS MODE (Product Details)

Scrape full product information from direct Sephora product URLs.

{
  "mode": "DIRECT_URLS",
  "urls": [
    "https://www.sephora.com/product/rare-beauty-soft-pinch-blush-P97989778"
  ]
}

✔ Product variants ✔ Pricing & images ✔ Cross-sell products ✔ Metadata (eligibility, returnability)

---

3. REVIEWS_ONLY MODE (Bazaarvoice Reviews)

Extract all customer reviews for a given Sephora product ID.

{
  "mode": "REVIEWS_ONLY",
  "urls": [
    "https://www.sephora.com/product/rare-beauty-soft-pinch-blush-P97989778"
  ],
  "maxItems": 200
}

✔ Full review history ✔ Ratings, comments, metadata ✔ Pagination support (offset-based) ✔ Works with Bazaarvoice API

---

4. QUESTIONS_ONLY MODE (Bazaarvoice Questions AND Answers)

Extract all customer questions and answers for a given Sephora product ID.

{
  "mode": "QUESTIONS_ONLY",
  "urls": [
    "https://www.sephora.com/product/rare-beauty-soft-pinch-blush-P97989778"
  ],
  "maxItems": 200
}

✔ Full questions and answers history ✔ Pagination support (offset-based) ✔ Works with Bazaarvoice API

---

📦 Input Schema

Field	Type	Description
mode	string	SEARCH / DIRECT_URLS / REVIEWS_ONLY / QUESTIONS_ONLY
queries	array	Search keywords (SEARCH mode)
urls	array	Product URLs (DIRECT_URLS / REVIEWS_ONLY / QUESTIONS_ONLY)
maxItems	number	Limit results (free/paid aware)

---

💎 Free vs Paid Usage

This scraper supports intelligent usage limits:

• Free users → capped results (default: 50 items)
• Paid users → full access to requested maxItems

Automatically handled via:

process.env.APIFY_USER_IS_PAYING

---

📊 Output Example

Product Review Object

{
  "productId": "P97989778",
  "Rating": 3,
  "ReviewText": "Pretty color but doesn't last long",
  "UserNickname": "user123",
  "SubmissionTime": "2026-04-14T01:28:31Z"
}

---

⚙️ Tech Stack

• Node.js (ESM)
• Apify SDK
• got-scraping
• Sephora API (v2/v3)
• Bazaarvoice Reviews API
• Bazaarvoice Questions API

---

🔥 Use Cases

• E-commerce data analysis
• Beauty product tracking
• Review sentiment mining
• Price & product monitoring
• AI dataset creation
• SEO keyword research for beauty niche

---

⚠️ Disclaimer

This actor is intended for educational and research purposes. Users are responsible for complying with website terms of service.

---

🚀 Modes Summary

• SEARCH MODE → keyword-based product scraping
• DIRECT_URLS MODE → full product extraction
• REVIEWS_ONLY MODE → deep customer review scraping
• QUESTIONS_ONLY MODE → deep customer questions and answers scraping

---

⭐ SEO Keywords

Sephora scraper, beauty scraper, product scraper, reviews scraper, Bazaarvoice scraper, e-commerce scraping, Sephora API scraper, cosmetic data extractor, skincare dataset scraper, makeup review scraper