{ "openapi": "3.0.1", "info": { "title": "Ulta Beauty Scraper — Products, Prices, Ingredients & Reviews", "description": "Scrape Ulta Beauty (ulta.com) products by search, category or brand: prices, sale prices, every shade with its own price, ingredients, stock, ratings and full customer reviews. Pay per result.", "version": "0.0", "x-build-id": "ncDPvck0ao1DY8B48" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~ulta-beauty-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-ulta-beauty-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/unfenced-group~ulta-beauty-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-ulta-beauty-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/unfenced-group~ulta-beauty-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-ulta-beauty-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", "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to search on ulta.com, exactly as in the site's search box, for example \"vitamin c serum\", \"mascara\" or \"curly hair shampoo\". Each term is searched separately. Leave empty when you only use Start URLs.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Ulta.com pages to collect from: category pages (https://www.ulta.com/shop/makeup/eyes/mascara), department pages (https://www.ulta.com/shop/makeup), brand pages (https://www.ulta.com/brand/tarte), sale and promotion pages (https://www.ulta.com/promotion/sale), search URLs (https://www.ulta.com/search?search=retinol) or single product pages. Filters already applied in the URL are kept.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "sortBy": { "title": "Sort order", "enum": [ "relevance", "best_sellers", "top_rated", "new_arrivals", "price_asc", "price_desc" ], "type": "string", "description": "Order in which search, category and brand results are collected: relevance (site default), best_sellers, top_rated, new_arrivals, price_asc (cheapest first) or price_desc (most expensive first). A sort already present in a Start URL wins.", "default": "relevance" }, "maxItems": { "title": "Max products", "minimum": 0, "type": "integer", "description": "Maximum number of products to return across all search terms and URLs. Reviews do not count towards this limit. Set to 0 for no limit.", "default": 100 }, "fetchDetails": { "title": "Fetch full product details", "type": "boolean", "description": "Open every product page and add the full description, ingredients, how to use, warnings, highlights (clean, vegan, cruelty free), size, every shade or size with its own price and availability, all images and videos, category path, stock, shipping and same-day delivery, current offers, Replenish & Save price and the star-rating breakdown. Billed as a product with details.", "default": false }, "variantPrices": { "title": "Price every shade and size", "type": "boolean", "description": "With full product details on, look up the exact price and availability of every shade and size, not only the one shown first. Adds no cost to you; turn off only to speed up runs on products with very many shades.", "default": true }, "includeReviews": { "title": "Include customer reviews", "type": "boolean", "description": "Add customer reviews as separate rows (recordType \"review\") directly after each product: rating, title, full text, reviewer nickname and location, date, recommend answer, verified-buyer flag, helpful votes, photos and whether the review was imported from the brand. Also adds the star-rating breakdown and recommend percentage to the product row.", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 0, "type": "integer", "description": "Maximum number of reviews to collect per product when reviews are included. Set to 0 to collect every review.", "default": 20 }, "reviewSort": { "title": "Review order", "enum": [ "newest", "oldest", "most_helpful", "highest_rating", "lowest_rating" ], "type": "string", "description": "Which reviews come first: newest, oldest, most_helpful, highest_rating or lowest_rating. Combine lowest_rating with a small review limit to collect only complaints.", "default": "newest" }, "brands": { "title": "Brands", "type": "array", "description": "Only return products of these brands, for example \"Tarte\", \"CeraVe\" or \"Ulta Beauty Collection\". Matching is case-insensitive and exact. Leave empty for all brands.", "default": [], "items": { "type": "string" } }, "minPrice": { "title": "Minimum price (USD)", "minimum": 0, "type": "integer", "description": "Only return products whose current price is at or above this amount in US dollars, for example 10. Leave empty for no minimum." }, "maxPrice": { "title": "Maximum price (USD)", "minimum": 0, "type": "integer", "description": "Only return products whose current price is at or below this amount in US dollars, for example 50. Leave empty for no maximum." }, "onlyOnSale": { "title": "Only products on sale", "type": "boolean", "description": "Only return products whose current price is below the regular price.", "default": false }, "minRating": { "title": "Minimum star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Only return products with an average rating at or above this number of stars (1 to 5), for example 4. Leave empty for no minimum." }, "inStockOnly": { "title": "Only products in stock", "type": "boolean", "description": "Skip products that are out of stock online. Stock is known for every product when full product details are on; without details, rows without a stock signal are kept.", "default": false }, "onlyChanges": { "title": "Only new products and price changes", "type": "boolean", "description": "Return only products that are new since your previous runs or whose price changed. Use with a daily schedule to get a feed of launches, price drops and price increases.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. The actor connects directly and switches to Apify Proxy by itself if the site starts refusing requests. Set a proxy here only to force one for every request.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }