{ "openapi": "3.0.1", "info": { "title": "Ulta Beauty Product & Review Scraper", "description": "Scrape Ulta Beauty (ulta.com) products by search, category, or brand. Get prices, ratings, sale status, and images from listing pages, plus full product details and customer reviews from product pages.", "version": "1.0", "x-build-id": "YjKZ12FXY4Uz7fTxX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~ulta-beauty-product-review-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-ulta-beauty-product-review-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/crawlerbros~ulta-beauty-product-review-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-ulta-beauty-product-review-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/crawlerbros~ulta-beauty-product-review-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-ulta-beauty-product-review-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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byCategory", "byBrand", "productDetails", "productReviews" ], "type": "string", "description": "What to fetch.", "default": "search" }, "searchQuery": { "title": "Search query (mode=search)", "type": "string", "description": "Free-text product search query, e.g. `lipstick`, `hyaluronic acid serum`.", "default": "lipstick" }, "categoryPath": { "title": "Category (mode=byCategory)", "enum": [ "all", "body-care", "body-care/all", "body-care/bath-body-accessories", "body-care/bath-body-accessories/bath-sponges-gloves-brushes", "body-care/bath-body-accessories/hair-towels-shower-caps", "body-care/bath-body-accessories/trend-fashion-accessories", "body-care/bath-shower", "body-care/bath-shower/bath-bombs-shower-steamers", "body-care/bath-shower/body-scrubs-exfoliants", "body-care/bath-shower/bubble-bath-soaks", "body-care/bath-shower/shower-gel-body-wash", "body-care/body-moisturizers", "body-care/body-moisturizers/body-butters", "body-care/body-moisturizers/body-lotion-creams", "body-care/body-moisturizers/body-serums-oils", "body-care/hand-foot-care", "body-care/hand-foot-care/hand-cream-foot-cream", "body-care/hand-foot-care/hand-foot-treatment", "body-care/hand-foot-care/hand-soap-sanitizers", "body-care/mother-baby", "body-care/personal-care", "body-care/personal-care/deodorant", "body-care/personal-care/hair-removal", "body-care/suncare", "body-care/suncare/after-sun-care", "body-care/suncare/self-tanning-bronzing", "body-care/suncare/sunscreen", "body-care/travel-size-body-care", "fragrance", "fragrance/all", "fragrance/candles-home-fragrance", "fragrance/fragrance-gift-sets", "fragrance/fragrance-gift-sets/cologne-gift-sets", "fragrance/fragrance-gift-sets/perfume-gift-sets", "fragrance/mens-fragrance", "fragrance/mens-fragrance/bath-shower", "fragrance/travel-size-fragrance", "fragrance/unisex-fragrance", "fragrance/womens-fragrance", "fragrance/womens-fragrance/bath-shower", "fragrance/womens-fragrance/body-lotions", "fragrance/womens-fragrance/body-mist-hair-mist", "fragrance/womens-fragrance/perfume", "gifts", "gifts/by-category", "gifts/by-category/body-care-gifts", "gifts/by-category/fragrance-gifts", "gifts/by-category/hair-gifts", "gifts/by-category/makeup-nail-gifts", "gifts/by-category/mens-gifts", "gifts/by-category/skin-gifts", "gifts/by-category/tool-brush-gifts", "gifts/by-category/wellness-gifts", "gifts/by-price", "gifts/by-price/100-under", "gifts/by-price/30-under", "gifts/by-price/50-under", "gifts/gifts-with-purchase", "hair", "hair/all", "hair/hair-brushes-combs", "hair/hair-color", "hair/hair-color/hair-color-bleach", "hair/hair-color/root-touch-up", "hair/hair-color/trend-color", "hair/kids-haircare", "hair/shampoo-conditioner", "hair/shampoo-conditioner/co-wash", "hair/shampoo-conditioner/conditioner", "hair/shampoo-conditioner/dry-shampoo", "hair/shampoo-conditioner/leave-in-conditioner", "hair/shampoo-conditioner/shampoo", "hair/styling-products", "hair/styling-products/curl-enhancing", "hair/styling-products/gloss-shine", "hair/styling-products/hairspray", "hair/styling-products/heat-protectant", "hair/styling-products/smoothing", "hair/styling-products/volume-texture", "hair/styling-products/wax-pomade", "hair/travel-size-hair-care", "hair/treatment", "hair/treatment/hair-thinning-hair-loss", "hair/treatment/leave-in-treatment", "hair/treatment/masks", "hair/treatment/oils-serums", "hair/treatment/scalp-care", "k-beauty", "k-beauty/hair-care", "k-beauty/hair-care/shampoo-conditioner", "k-beauty/hair-care/treatment", "k-beauty/makeup", "k-beauty/makeup/eyes", "k-beauty/makeup/face", "k-beauty/makeup/lips", "k-beauty/skin-care", "k-beauty/skin-care/body-care", "k-beauty/skin-care/cleansers", "k-beauty/skin-care/eye-treatments", "k-beauty/skin-care/moisturizers", "k-beauty/skin-care/suncare", "k-beauty/skin-care/treatment-serums", "luxury-at-ulta-beauty/fragrance", "luxury-at-ulta-beauty/makeup", "luxury-at-ulta-beauty/skin-care", "luxury-beauty", "makeup", "makeup/all", "makeup/body-makeup", "makeup/eyes", "makeup/eyes/eye-primer-base", "makeup/eyes/eyebrows", "makeup/eyes/eyelashes", "makeup/eyes/eyeliner", "makeup/eyes/eyeshadow", "makeup/eyes/eyeshadow-palettes", "makeup/eyes/lash-primer-serums", "makeup/eyes/mascara", "makeup/face", "makeup/face/bb-cc-creams", "makeup/face/blush", "makeup/face/bronzer", "makeup/face/color-correcting", "makeup/face/concealer", "makeup/face/contouring", "makeup/face/face-primer", "makeup/face/foundation", "makeup/face/highlighter", "makeup/face/setting-spray-powder", "makeup/lips", "makeup/lips/lip-balms", "makeup/lips/lip-gloss", "makeup/lips/lip-liner", "makeup/lips/lip-oil", "makeup/lips/lip-plumpers", "makeup/lips/lip-stain", "makeup/lips/lip-treatments", "makeup/lips/lipstick", "makeup/makeup-bags-organizers", "makeup/makeup-palettes", "makeup/nails", "makeup/nails/gel-nail-polish", "makeup/nails/manicure-pedicure-tools", "makeup/nails/nail-art-design", "makeup/nails/nail-care", "makeup/nails/nail-polish", "makeup/nails/nail-polish-stickers", "makeup/nails/press-on-nails", "makeup/nails/top-base-coats", "makeup/travel-size-makeup", "men", "men/body-care", "men/body-care/body-lotion", "men/body-care/deodorant", "men/body-care/shower-gel-body-wash", "men/cologne", "men/hair", "men/hair/conditioner", "men/hair/hair-thinning-hair-loss", "men/hair/shampoo", "men/hair/styling", "men/shaving", "men/shaving/aftershave", "men/shaving/beard-care", "men/shaving/shaving-cream-razors", "men/skin-care", "men/skin-care/face-wash", "men/skin-care/moisturizers-treatments", "men/travel-size-mens-care", "new-beauty-products", "skin-care", "skin-care/all", "skin-care/cleansers", "skin-care/cleansers/cleansing-balms-oils", "skin-care/cleansers/cleansing-exfoliators", "skin-care/cleansers/face-wash", "skin-care/cleansers/face-wipes", "skin-care/cleansers/makeup-remover", "skin-care/cleansers/toner", "skin-care/dermatologist-recommended", "skin-care/eye-treatments", "skin-care/eye-treatments/eye-cream", "skin-care/eye-treatments/eye-masks", "skin-care/eye-treatments/eye-serums", "skin-care/moisturizers", "skin-care/moisturizers/face-mists-essences", "skin-care/moisturizers/face-moisturizer", "skin-care/moisturizers/face-oils", "skin-care/moisturizers/neck-cream", "skin-care/moisturizers/night-cream", "skin-care/moisturizers/tinted-moisturizer", "skin-care/travel-size-skin-care", "skin-care/treatment-serums", "skin-care/treatment-serums/acne-blemish-treatments", "skin-care/treatment-serums/body-treatments", "skin-care/treatment-serums/face-masks", "skin-care/treatment-serums/face-peels-exfoliators", "skin-care/treatment-serums/face-serums", "skin-care/treatment-serums/sheet-masks", "tools-brushes", "tools-brushes/accessories", "tools-brushes/accessories/clips-bobby-pins", "tools-brushes/accessories/elastics", "tools-brushes/accessories/hair-cutting-tools", "tools-brushes/accessories/hair-extensions", "tools-brushes/accessories/headbands", "tools-brushes/accessories/styling-accessories", "tools-brushes/hair-removal-tools", "tools-brushes/hair-styling-tools", "tools-brushes/hair-styling-tools/curling-irons-stylers", "tools-brushes/hair-styling-tools/flat-irons", "tools-brushes/hair-styling-tools/hair-dryers", "tools-brushes/hair-styling-tools/hair-rollers", "tools-brushes/hair-styling-tools/hot-brushes", "tools-brushes/makeup-brushes-tools", "tools-brushes/makeup-brushes-tools/brow-lash-tools", "tools-brushes/makeup-brushes-tools/brush-cleaner", "tools-brushes/makeup-brushes-tools/brush-sets", "tools-brushes/makeup-brushes-tools/makeup-brushes", "tools-brushes/makeup-brushes-tools/mirrors", "tools-brushes/makeup-brushes-tools/sponges-applicators", "tools-brushes/skincare-tools", "tools-brushes/skincare-tools/anti-aging", "tools-brushes/skincare-tools/cleansing-brushes", "tools-brushes/skincare-tools/facial-rollers", "travel-size-mini", "wellness-by-ulta-beauty", "wellness-by-ulta-beauty/all", "wellness-by-ulta-beauty/essential-routines", "wellness-by-ulta-beauty/essential-routines/body-essentials", "wellness-by-ulta-beauty/essential-routines/movement-fitness", "wellness-by-ulta-beauty/essential-routines/oral-care", "wellness-by-ulta-beauty/essential-routines/wearables-devices", "wellness-by-ulta-beauty/intimate-care", "wellness-by-ulta-beauty/intimate-care/feminine-hygiene", "wellness-by-ulta-beauty/intimate-care/menopausal-care", "wellness-by-ulta-beauty/intimate-care/period-care", "wellness-by-ulta-beauty/intimate-care/prenatal-postnatal-care", "wellness-by-ulta-beauty/intimate-care/sexual-wellness", "wellness-by-ulta-beauty/nutrition-supplements", "wellness-by-ulta-beauty/nutrition-supplements/beauty-supplements", "wellness-by-ulta-beauty/nutrition-supplements/daily-vitamins-supplements", "wellness-by-ulta-beauty/nutrition-supplements/digestion-gut-health", "wellness-by-ulta-beauty/nutrition-supplements/hydration", "wellness-by-ulta-beauty/nutrition-supplements/protein-fitness", "wellness-by-ulta-beauty/nutrition-supplements/sleep-stress-relief", "wellness-by-ulta-beauty/nutrition-supplements/womens-health", "wellness-by-ulta-beauty/rest-reset", "wellness-by-ulta-beauty/rest-reset/aromatherapy", "wellness-by-ulta-beauty/rest-reset/relief-recovery", "wellness-by-ulta-beauty/rest-reset/sleep-support", "wellness-by-ulta-beauty/rest-reset/spa-essentials" ], "type": "string", "description": "Ulta category taxonomy path to browse.", "default": "makeup/lips/lipstick" }, "brandSlug": { "title": "Brand (mode=byBrand)", "enum": [ "about-face", "amika", "arrae", "balmain-paris", "bath-body-works", "beekman-1802", "better-world-fragrance-house", "buttah-skin", "cecred", "charlotte-tilbury", "cocokind", "cymbiotika", "design-essentials", "dibs-beauty", "divi", "dphue", "drmtlgy", "eva-nyc", "fenty-skin-body", "fwee", "gruns", "gucci", "hairstory", "half-magic", "honey-pot-company", "isima", "juvias-place", "kevyn-aucoin", "lemme", "live-tinted", "living-proof", "maelys", "maryruths", "medicine-mama", "milk-makeup", "moroccanoil", "nemat", "neom-wellbeing", "nodpod", "noyz", "nyx-professional-makeup", "octavia-morgan-los-angeles", "pat-mcgrath-labs", "patchology", "pattern", "peach-lily", "polite-society", "rare-beauty", "redken", "saje-natural-wellness", "scarlet-by-reddrop", "sol-de-janeiro", "squishmallows-fragrances", "stripes-beauty-by-naomi-watts", "tgin", "therabody", "ulta-beauty-collection" ], "type": "string", "description": "Curated list of ~57 Ulta brand slugs discoverable from the homepage brand rail. For any other brand, use the Custom brand slug field below to override this.", "default": "rare-beauty" }, "customBrandSlug": { "title": "Custom brand slug (mode=byBrand, overrides dropdown)", "type": "string", "description": "Any Ulta brand slug from the brand page URL, e.g. `fenty-skin-body` (from https://www.ulta.com/brand/fenty-skin-body). Overrides the Brand dropdown above if set. Use this for brands not in the curated list (Ulta carries ~700 brands total)." }, "productUrls": { "title": "Product URLs (mode=productDetails / productReviews)", "type": "array", "description": "Full Ulta product page URLs, e.g. `https://www.ulta.com/p/vice-hydrating-lipstick-pimprod2026577?sku=2584521`. Get these from the `productUrl` field of a search/category/brand run.", "default": [], "items": { "type": "string" } }, "sortBy": { "title": "Sort by (listing modes)", "enum": [ "relevance", "best_sellers", "price_asc", "price_desc", "new_arrivals", "top_rated" ], "type": "string", "description": "Server-side sort order applied by Ulta's own \"Sort by\" control on search, category, and brand listing pages.", "default": "relevance" }, "preferences": { "title": "Preferences / Clean at Ulta (listing modes)", "type": "array", "description": "Only include products matching ALL selected ingredient/formulation preferences (Ulta's \"Preferences\" filter panel). Leave empty to skip this filter.", "items": { "type": "string", "enum": [ "clean_ingredients", "cruelty_free", "vegan", "sustainable_packaging", "give_back", "aha_glycolic_acid", "alcohol_free", "antioxidants", "cbd", "fragrance_free", "gluten_free", "hyaluronic_acid", "mineral", "niacinamide", "non_comedogenic", "oil_free", "paraben_free", "peptides", "phthalate_free", "salicylic_acid", "silicone_free", "sulfate_free", "talc_free" ], "enumTitles": [ "Clean Ingredients", "Cruelty Free", "Vegan", "Sustainable Packaging", "Give Back", "Aha / Glycolic Acid", "Alcohol Free", "Antioxidants", "Cbd", "Fragrance Free", "Gluten Free", "Hyaluronic Acid", "Mineral", "Niacinamide", "Non Comedogenic", "Oil Free", "Paraben Free", "Peptides", "Phthalate Free", "Salicylic Acid", "Silicone Free", "Sulfate Free", "Talc Free" ] }, "default": [] }, "shoppingPreference": { "title": "Shopping preference (listing modes)", "enum": [ "", "exclusive", "dermatologist_recommended", "k_beauty", "online_only", "refill", "refillable" ], "type": "string", "description": "Only include products matching this Ulta \"Shopping Preference\" facet.", "default": "" }, "specialOffer": { "title": "Special offer (listing modes)", "enum": [ "", "gwp", "bmsm" ], "type": "string", "description": "Only include products carrying this Ulta \"Special Offers\" badge. For markdown/sale pricing, use `onSaleOnly` below instead.", "default": "" }, "minRating": { "title": "Minimum rating (listing modes)", "minimum": 0, "maximum": 5, "type": "number", "description": "Drop products with an average rating below this value (0-5). Products with no rating pass through." }, "minReviewCount": { "title": "Minimum review count (listing modes)", "minimum": 0, "type": "integer", "description": "Drop products with fewer reviews than this. Products with no review count pass through." }, "maxPrice": { "title": "Maximum price (listing modes)", "minimum": 0, "type": "number", "description": "Drop products priced above this amount (USD). Products with no price pass through." }, "onSaleOnly": { "title": "On sale only (listing modes)", "type": "boolean", "description": "Only emit products currently marked down from their original price.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on emitted records (products, or reviews in mode=productReviews). The actor scrolls and paginates as far as Ulta's own listing pages allow to get as close to this number as possible. Note: Ulta's anti-bot layer can intermittently limit automated access beyond the first results page (roughly 50-90 products/one search or category page) regardless of this setting - the actor automatically retries blocked pages with a fresh session and proxy identity, but a very large maxItems value is not always fully reachable on every run.", "default": 60 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Ulta listing pages usually load fine without a proxy; the actor automatically retries through the free Apify AUTO proxy group if it detects a block. Only the free datacenter (AUTO) group is used - no paid residential proxy.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }