Sephora Scraper Documentation

Overview

The Sephora Scraper is an Apify actor designed to extract comprehensive product information from Sephora.com. By providing a list of product URLs as input, the scraper retrieves details such as product name, brand, pricing, availability, reviews, and more.

---

Input Configuration

The input for the Sephora Scraper should be a JSON object containing the following keys:

• proxyConfiguration: Specifies the proxy settings. Use the Apify residential proxy group for optimal performance.
• urls: An array of Sephora product URLs to scrape.

Input Example

1{
2    "proxyConfiguration": {
3        "useApifyProxy": true,
4        "apifyProxyGroups": [
5            "RESIDENTIAL"
6        ]
7    },
8    "urls": [
9        "https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778?skuId=2362085&icid2=homepage_productlist_chosenforyou_us_rwd_092022"
10    ]
11}

---

Output

The scraper returns a JSON array of objects, where each object contains detailed information about the product, including:

• url: The product URL provided in the input.
• name: The name of the product.
• brand: The brand of the product.
• product_offers: An array of pricing and availability details for different SKUs, including:
  • price: The product price.
  • priceCurrency: The currency of the price.
  • availability: Availability status (e.g., InStock, OutOfStock).
  • sku: Stock Keeping Unit (SKU) identifier.
  • image: URL of the product image.
  • seller: The seller's name.
• aggregateRating: Overall rating details, including:
  • reviewCount: Total number of reviews.
  • bestRating: The highest possible rating.
  • ratingValue: The average rating value.
• reviewCount: Total number of reviews.
• description: A brief description of the product.
• image: An array of product images.
• reviews: An array of review details, including:
  • id: Review ID.
  • name: Reviewer's name.
  • datePublished: Date the review was published.
  • description: Content of the review.
  • reviewRating: Rating details, including bestRating, ratingValue, and itemReviewed.

Output Example

1[
2    {
3        "url": "https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778",
4        "name": "Soft Pinch Liquid Blush",
5        "brand": "Rare Beauty by Selena Gomez",
6        "product_offers": [
7            {
8                "price": "25.0",
9                "priceCurrency": "USD",
10                "availability": "http://schema.org/InStock",
11                "sku": "2362143",
12                "image": "https://www.sephora.com/productimages/sku/s2362143-main-hero.jpg",
13                "seller": "Sephora"
14            },
15            {
16                "price": "15.0",
17                "priceCurrency": "USD",
18                "availability": "http://schema.org/OutOfStock",
19                "sku": "2761989",
20                "image": "https://www.sephora.com/productimages/sku/s2761989-main-hero.jpg",
21                "seller": "Sephora"
22            }
23        ],
24        "aggregateRating": {
25            "reviewCount": "12262",
26            "bestRating": "5",
27            "ratingValue": "4.5402",
28            "itemReviewed": {
29                "name": "Soft Pinch Liquid Blush"
30            }
31        },
32        "reviewCount": "12262",
33        "description": "Shop Rare Beauty’s Soft Pinch Liquid Blush at Sephora. This weightless, long-lasting liquid blush blends and builds beautifully for a soft, healthy flush.",
34        "image": [
35            "https://www.sephora.com/productimages/sku/s2362085-main-hero.jpg"
36        ],
37        "reviews": [
38            {
39                "id": "330906076",
40                "name": ["vickyyvick"],
41                "datePublished": ["2025-01-02"],
42                "description": ["After using this product, it’s very nice on the skin. But, I will say that it leaves the mark of the liquid and it’s a little hard to blend 😭. So, take that as you will, but the product is good overall. I got it in the color ‘Bliss’."],
43                "reviewRating": {
44                    "bestRating": "5",
45                    "ratingValue": "3",
46                    "itemReviewed": "Soft Pinch Liquid Blush"
47                }
48            }
49        ]
50    }
51]

---

Usage Instructions

1. Input Preparation: Create a JSON file with the proxyConfiguration and urls array containing the product URLs to scrape.
2. Actor Execution: Run the Sephora Scraper actor on the Apify platform, providing the input JSON file.
3. Retrieve Results: After the execution, download the output JSON containing the scraped data.

---

Support

For custom outputs, simplified formats, or to report any issues, please contact:

• Email: support@getdataforme.com
• Contact Form: https://getdataforme.com/contact/

When reaching out, please include a clear subject line and a detailed description of your request or issue.

---

Thank you for using the Sephora Scraper!