{ "openapi": "3.0.1", "info": { "title": "Sephora Scraper: Prices, Sales & Ratings", "description": "Scrape Sephora US category pages. One row per product: price, list price range, sale price and sale type, rating, review count, number of shades or sizes, New and Bestseller flags. Sort, filter by brand, price, sale and rating. Export JSON, CSV or Excel.", "version": "0.1", "x-build-id": "p2MCcgDBqOGXUWQkR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/reventadata~sephora-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-reventadata-sephora-scraper", "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/reventadata~sephora-scraper/runs": { "post": { "operationId": "runs-sync-reventadata-sephora-scraper", "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/reventadata~sephora-scraper/run-sync": { "post": { "operationId": "run-sync-reventadata-sephora-scraper", "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": [ "startUrls" ], "properties": { "startUrls": { "title": "Category pages", "type": "array", "description": "Sephora US category pages, for example https://www.sephora.com/shop/moisturizing-cream-oils-mists or https://www.sephora.com/shop/lipstick. Only www.sephora.com/shop/ URLs are read: search pages, /browse/ pages and product pages are refused. Query strings are ignored: the Actor sets page, sort and filters itself.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum items", "minimum": 1, "type": "integer", "description": "Total number of products to save across all start URLs, counted after the filters. A category page holds 60 products.", "default": 100 }, "maxPages": { "title": "Maximum pages per category", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Result pages to walk per start URL, 60 products each. The Actor waits 5 seconds between page requests (the site's robots.txt Crawl-delay), so 17 pages, about 1,000 products, take about 3 minutes (measured 2026-10-21: 1,000 products from 19 pages in 200 seconds).", "default": 5 }, "sort": { "title": "Sort order", "enum": [ "RELEVANCE", "BEST_SELLING", "TOP_RATED", "PRICE_LOW_TO_HIGH", "PRICE_HIGH_TO_LOW", "NEW" ], "type": "string", "description": "Order of the products, applied by the site before the Actor reads them. Price orders let a small maxItems return the cheapest or dearest products first.", "default": "RELEVANCE" }, "brands": { "title": "Brands", "type": "array", "description": "Keep only these brands, spelled as Sephora shows them (for example Tatcha, LANEIGE, Charlotte Tilbury). Several brands are OR: a product of any of them is kept. The site applies the filter. A brand with no products in the category returns no rows.", "items": { "type": "string" } }, "minPrice": { "title": "Minimum price (USD)", "minimum": 0, "type": "number", "description": "Keep only products priced at or above this amount in US dollars. The site applies it to the whole list-price range: a product listed at $42.00 - $59.00 is dropped when this is 45. Leave empty for no minimum." }, "maxPrice": { "title": "Maximum price (USD)", "minimum": 0, "type": "number", "description": "Keep only products priced at or below this amount in US dollars. The site applies it to the whole list-price range: a product listed at $29.00 - $50.00 is dropped when this is 40. Leave empty for no maximum." }, "onlyOnSale": { "title": "Only products on sale", "type": "boolean", "description": "Keep only products Sephora flags as on sale: every size or shade marked down, or only some of them (saleType FULL or PARTIAL in the row).", "default": false }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Keep only products with an average customer rating at or above this value (0 to 5). Unrated products are dropped when this is set." }, "includeKeywords": { "title": "Must contain", "type": "array", "description": "Keep only products whose name, brand or category contains every one of these words, ignoring case and accents.", "items": { "type": "string" } }, "excludeKeywords": { "title": "Must not contain", "type": "array", "description": "Drop products whose name, brand or category contains any of these words, ignoring case and accents.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify residential proxy in the United States is required: no proxy and datacenter proxies get an 'Access Denied' page from sephora.com.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }