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 json { "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "urls": [ "https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778?skuId=2362085&icid2=homepage_productlist_chosenforyou_us_rwd_092022" ] } --- ## 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 json [ { "url": "https://www.sephora.com/product/rare-beauty-by-selena-gomez-soft-pinch-liquid-blush-P97989778", "name": "Soft Pinch Liquid Blush", "brand": "Rare Beauty by Selena Gomez", "product_offers": [ { "price": "25.0", "priceCurrency": "USD", "availability": "http://schema.org/InStock", "sku": "2362143", "image": "https://www.sephora.com/productimages/sku/s2362143-main-hero.jpg", "seller": "Sephora" }, { "price": "15.0", "priceCurrency": "USD", "availability": "http://schema.org/OutOfStock", "sku": "2761989", "image": "https://www.sephora.com/productimages/sku/s2761989-main-hero.jpg", "seller": "Sephora" } ], "aggregateRating": { "reviewCount": "12262", "bestRating": "5", "ratingValue": "4.5402", "itemReviewed": { "name": "Soft Pinch Liquid Blush" } }, "reviewCount": "12262", "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.", "image": [ "https://www.sephora.com/productimages/sku/s2362085-main-hero.jpg" ], "reviews": [ { "id": "330906076", "name": ["vickyyvick"], "datePublished": ["2025-01-02"], "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’."], "reviewRating": { "bestRating": "5", "ratingValue": "3", "itemReviewed": "Soft Pinch Liquid Blush" } } ] } ] --- ## 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!