# Sephora (`datasaurus/sephora`) Actor Scrape products from Sephora US, Canada and UK websites. Includes reviews, Q\&As and ingredients. Fast and efficient. - **URL**: https://apify.com/datasaurus/sephora.md - **Developed by:** [datasaurus](https://apify.com/datasaurus) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 product-pages This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Sephora Products Scraper Scrapes Sephora product data for: - UK (`sephora.co.uk`) - US (`sephora.com`) - EU (`sephora.fr`, `sephora.de`, `sephora.it`, etc.) is not supported. ### Example Inputs #### UK Product With Detailed Page + Reviews ```json { "start_urls": [ { "url": "https://www.sephora.co.uk/p/benefit-cosmetics-benetint-lip-cheek-stain" } ], "scrape_product_page": true, "max_products": 1, "max_reviews_per_product": 5 } ```` ### Example Output ```json { "name": "Hyaluronic Acid 2% + B5 Hydrating Serum with Ceramides", "brand": "The Ordinary", "sku": "2735132", "pid": "P427419", "price": 9.9, "rrp": 9.9, "currency": "USD", "link": "https://www.sephora.com/product/the-ordinary-hyaluronic-acid-2-b5-hydrating-serum-P427419?skuId=2735132", "imageUrl": "https://www.sephora.com/productimages/sku/s2735132-main-zoom.jpg?imwidth=62", "description": "A reformulation of our most-loved hydration serum that instantly hydrates and plumps, while smoothing texture and wrinkles.", "whatItIs": "A lightweight hydration serum with Ceramides that instantly hydrates and plumps, while smoothing texture and wrinkles.", "aboutProduct": "This next generation formulation provides instant and long-term plumping hydration to give softer, smoother, and healthy-looking skin.", "size": "1 oz / 30 ml", "highlights": ["alcoholFree","Cruelty-Free","Fragrance-Free","hyaluronicAcid","oilFree","Paraben-Free","siliconeFree","Sulfate-Free","Vegan","Bestseller"], "highlightedIngredients": [ {"name": "Five forms of Hyaluronic Acid", "description": "Work different layers of skin’s surface to hold water"}, {"name": "Ceramides", "description": "Oil-like molecules that support the skin barrier"}, {"name": "Vitamin B5", "description": "Works within the skin moisture barrier to maintain it"} ], "reviewRating": 4.3103, "reviewCount": 1566, "reviews": [ { "text": "if i had to pick one thing to always have it would be Hyaluronic acid! And The Ordinary added more with it into one bottle.......love this. This product is something I added to my morning skincare routine about 6 months ago and I would keep it forever. PLUS its affordable.", "rating": 5, "title": "Key to having glassy looking skin", "author": "mrschristyp", "date": "2026-04-12T19:59:25.000+00:00", "recommended": true }, { "text": "I first bought this way back in 2021, and I’ve used it ever since! I’ve tried different Hyaluronic acid serums since then, but nothing compares to this one. I spray a layer of water on my face before putting this stuff on, and my skin stays hydrated all day! LOVE this serum!!!!!", "rating": 5, "title": "Been Using Since 2021", "author": "MikkiePope", "date": "2026-04-11T23:52:40.000+00:00", "recommended": true }, { "text": "Was looking for an extra OOMPH in my routine for my dry skin, tried this at the store and it had a good consistency and decided to pick it up. And omg I’m OBSESSED!!!!! It’s definitely a holy grail for me now. It doesn’t sit on top of your skin or weigh it down, you can feel literally feel it moisturizing your skin with no oiliness.", "rating": 5, "title": "New holy grail", "author": "EmilyRampulla", "date": "2026-04-08T16:16:01.000+00:00", "recommended": true } ], "questionsAnswers": [ { "question": "Does this product have an expiration date?", "answers": [ { "text": "no. Although it does build up a little on the cap.", "author": "saieslay", "date": "2026-03-22T20:48:32.000+00:00", "is_brand_answer": false } ] }, { "question": "I just started using this after having it for two months. It has a yellowy tint and a weird smell. Is this normal?", "answers": [ { "text": "If you read the package, it says it has a yellow tint because of the ceramides..", "author": "MistyVP", "date": "2026-02-15T04:38:55.000+00:00", "is_brand_answer": false } ] } ] } ``` ### Pricing (Pay-Per-Event) This Actor uses pay-per-event billing. You are only charged for what you actually scrape. | Event | Price | When charged | |---|---|---| | `product-listing` | $0.002 | Each product discovered from a category/brand listing | | `product-page` | $0.005 | Each product enriched with full detail from the product page (ingredients, directions, sizes) | | `review` | $0.0005 | Per individual customer review fetched | | `question-answer` | $0.0005 | Per individual Q\&A item fetched | **When is `product-page` charged?**\ `product-page` is charged (instead of `product-listing`) whenever product page scraping runs. This happens when: - `scrape_product_page` is `true`, **or** - `max_reviews` is greater than `0`, **or** - `max_question_answers` is greater than `0` Setting `max_reviews` or `max_question_answers` above `0` **automatically enables product page scraping** — you do not need to also set `scrape_product_page: true`. Reviews and Q\&A are fetched during the product page pass, so the `product-page` event is charged per product in all these cases, in addition to `review` and `question-answer` per fetched item. To get only listing data with no page charges, set `scrape_product_page: false`, `max_reviews: 0`, and `max_question_answers: 0`. # Actor input Schema ## `start_urls` (type: `array`): UK (sephora.co.uk), US (sephora.com), or EU (sephora.fr/de/it — detected and aborted). Website: https://www.sephora.co.uk/ Category: https://www.sephora.co.uk/makeup Brand: https://www.sephora.co.uk/brands/fenty-hair Product: https://www.sephora.co.uk/p/benefit-cosmetics-benetint-lip-cheek-stain US category: https://www.sephora.com/shop/foundation US brand: https://www.sephora.com/brand/fenty ## `scrape_product_page` (type: `boolean`): UK: scrapes each product page for full details, ingredients, reviews and Q\&A. Note: this is automatically enabled when max\_reviews or max\_question\_answers are greater than 0. ## `max_products` (type: `integer`): Maximum number of products to scrape. Use lower numbers for testing. ## `max_products_per_category` (type: `integer`): Maximum number of products to scrape per category when scraping the whole site. Leave blank to use Max Products as the per-category limit. ## `max_reviews` (type: `integer`): Maximum number of reviews to fetch per product. Set to 0 to turn off review scraping. Setting this above 0 automatically enables product page scraping and charges the product-page event per product. ## `max_question_answers` (type: `integer`): Maximum number of question/answer entries to fetch per product. Set to 0 to turn off Q\&A scraping. Setting this above 0 automatically enables product page scraping and charges the product-page event per product. ## Actor input object example ```json { "start_urls": [ { "url": "https://www.sephora.co.uk/makeup" }, { "url": "https://www.sephora.co.uk/skin" } ], "scrape_product_page": false, "max_products": 10, "max_reviews": 10, "max_question_answers": 10 } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "start_urls": [ { "url": "https://www.sephora.co.uk/makeup" }, { "url": "https://www.sephora.co.uk/skin" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("datasaurus/sephora").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "start_urls": [ { "url": "https://www.sephora.co.uk/makeup" }, { "url": "https://www.sephora.co.uk/skin" }, ] } # Run the Actor and wait for it to finish run = client.actor("datasaurus/sephora").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "start_urls": [ { "url": "https://www.sephora.co.uk/makeup" }, { "url": "https://www.sephora.co.uk/skin" } ] }' | apify call datasaurus/sephora --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=datasaurus/sephora", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Sephora", "description": "Scrape products from Sephora US, Canada and UK websites. Includes reviews, Q&As and ingredients. Fast and efficient.", "version": "0.1", "x-build-id": "ILgjFB8GfcuODWBPP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datasaurus~sephora/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datasaurus-sephora", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/datasaurus~sephora/runs": { "post": { "operationId": "runs-sync-datasaurus-sephora", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/datasaurus~sephora/run-sync": { "post": { "operationId": "run-sync-datasaurus-sephora", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "start_urls" ], "properties": { "start_urls": { "title": "Start URLs - main site, category, brand, or product page", "uniqueItems": true, "type": "array", "description": "UK (sephora.co.uk), US (sephora.com), or EU (sephora.fr/de/it — detected and aborted).\nWebsite: https://www.sephora.co.uk/\nCategory: https://www.sephora.co.uk/makeup\nBrand: https://www.sephora.co.uk/brands/fenty-hair\nProduct: https://www.sephora.co.uk/p/benefit-cosmetics-benetint-lip-cheek-stain\nUS category: https://www.sephora.com/shop/foundation\nUS brand: https://www.sephora.com/brand/fenty", "default": [ { "url": "https://www.sephora.co.uk/makeup" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "scrape_product_page": { "title": "Scrape Product Page for full details, ingredients, reviews and Q&A", "type": "boolean", "description": "UK: scrapes each product page for full details, ingredients, reviews and Q&A.\nNote: this is automatically enabled when max_reviews or max_question_answers are greater than 0.", "default": false }, "max_products": { "title": "Max Products - Maximum number of products to scrape per start url", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of products to scrape. Use lower numbers for testing.", "default": 10 }, "max_products_per_category": { "title": "Max Products per Category - applies when scraping whole site. Leave blank to use Max Products as the per-category limit.", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of products to scrape per category when scraping the whole site. Leave blank to use Max Products as the per-category limit." }, "max_reviews": { "title": "Max Reviews per product – set to 0 to turn off", "minimum": 0, "maximum": 100, "type": "integer", "description": "Maximum number of reviews to fetch per product. Set to 0 to turn off review scraping.\nSetting this above 0 automatically enables product page scraping and charges the product-page event per product.", "default": 10 }, "max_question_answers": { "title": "Max Question Answers per product – set to 0 to turn off", "minimum": 0, "maximum": 100, "type": "integer", "description": "Maximum number of question/answer entries to fetch per product. Set to 0 to turn off Q&A scraping.\nSetting this above 0 automatically enables product page scraping and charges the product-page event per product.", "default": 10 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```