{"name":"ulta","domain":"ulta.com","baseUrl":"https://www.ulta.com","displayName":"Ulta Beauty","description":"Public US beauty product documents.","notes":"`listCategoryProducts(department, category, subcategory)` discovers across brands using three ordered segments from a public `/shop/` link, such as `makeup/face/foundation` or `skin-care/moisturizers/night-cream`. Each input is one segment. It returns initial category cards; full catalog, pagination and filters are unverified. Pass each returned product URL and SKU to `getProduct` as above.\n\n`listBrandProducts(brandSlug)` reads product cards from the initial public brand document, in document order. Copy the slug from an Ulta `/brand/` link, such as `olaplex` or `redken`. For detail, split the returned `url` at `/p/` to get `productPath` and pass its `sku` to `getProduct`. Results may cover only part of the catalog; pagination, filters and hydrated updates are unverified. Card SKU is the linked item, not a promise that all variants are listed.\n\n`getProduct(productPath, sku)` reads a public US product document. Copy both inputs from the same Ulta product link. `productPath` is the complete segment after `/p/`, without slash or query. For example, use `productPath=niacinamide-10-zinc-1-serum-oily-skin-pimprod2007111 sku=2551167`.\n\nThe family ID and SKU identify different things. The returned SKU, size and offer URL describe the item actually represented by the document; check them against the requested item. The checked larger niacinamide variant returned SKU `2614594`, `4.0 oz`, and `19.60 USD`, while the original item returned SKU `2551167`, `1.0 oz`, and `6.00 USD`.\n\n`price` is the main advertised schema.org offer in the returned document, not a subscription amount, checkout total or delivery quote. Prices may change. Stock, pickup, store availability, delivery and reviews are outside this operation. No account or private browser session was used. Other product layouts, countries and currencies are unverified.","operations":[{"hash":"558d8ae537dfa7e60d5c0da831240c48a90d490ec8a1b91d36fbb44c37746f64","status":"live","confirmations":0,"operation":{"name":"getProduct","description":"Read public US product document identity, size and advertised main offer; no stock or delivery guarantees.","request":{"method":"GET","url":"https://www.ulta.com/p/%7BproductPath%7D?sku=%7Bsku%7D","headers":{"accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/jxl,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7","upgrade-insecure-requests":"1","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/155.0.0.0 Safari/537.36","sec-ch-ua":"\"Google Chrome\";v=\"155\", \"Chromium\";v=\"155\", \"Not(A:Brand\";v=\"24\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\""}},"slots":[{"param":"productPath","at":["path:1"]},{"param":"sku","at":["query:sku"]}],"volatile":[],"trigger":{"url":"https://www.ulta.com/p/{productPath}?sku={sku}"},"match":{"method":"GET","host":"www.ulta.com","path":"/p/*"},"response":{"format":"embedded","contentType":"text/html","pick":["familyId=productID","sku","name","brand","size=Size","price=offers.price","currency=offers.priceCurrency","offerUrl=offers.url"],"embedded":{"regex":"<script[^>]*type=\"application/ld\\+json\"[^>]*>(\\{\"@context\":\"https://schema.org/\",\"@type\":\"Product\"[\\s\\S]*?)</script>"}},"params":[{"name":"productPath","type":"string","required":true,"description":"Full product path segment copied from a public Ulta product link.","example":"niacinamide-10-zinc-1-serum-oily-skin-pimprod2007111","pattern":"[A-Za-z0-9-]+","hint":"Full product path segment, without slash or query."},{"name":"sku","type":"string","required":true,"description":"SKU identifier from the same public product link; returned sku is authoritative.","example":"2551167","pattern":"[0-9]+","hint":"A numeric SKU ID copied from the same product link."}],"readOnly":true,"minTier":1,"learnedLoggedIn":false,"checks":[{"args":{"productPath":"glycolic-acid-7-exfoliating-brightening-daily-toner-pimprod2007097","sku":"2551155"},"expect":"result","purpose":"Different product family or SKU must return its own identity, selected size and main offer."},{"args":{"productPath":"niacinamide-10-zinc-1-serum-oily-skin-pimprod2007111","sku":"2614594"},"expect":"result","purpose":"Different product family or SKU must return its own identity, selected size and main offer."}]}},{"hash":"84f8558bc875a9c18fd72813474cc16e6a8f17c176ec6509eac30c033bc08c81","status":"live","confirmations":0,"operation":{"name":"listBrandProducts","description":"List the product cards in a public US brand document, in document order, with names and SKU-bearing detail links. Initial document only; no full-catalog or stock guarantee.","request":{"method":"GET","url":"https://www.ulta.com/brand/%7BbrandSlug%7D","headers":{"accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/jxl,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7","upgrade-insecure-requests":"1","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36","sec-ch-ua":"\"Not:A-Brand\";v=\"8\", \"Chromium\";v=\"156\", \"Google Chrome\";v=\"156\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\""}},"slots":[{"param":"brandSlug","at":["path:1"]}],"volatile":[],"trigger":{"url":"https://www.ulta.com/brand/{brandSlug}"},"match":{"method":"GET","host":"www.ulta.com","path":"/brand/*"},"response":{"format":"html","contentType":"text/html","html":{"items":".ProductListingResults__productList .ProductListingResults__productCard","fields":{"name":".pal-c-ProductCardBody--title","brand":".pal-c-ProductCardBody--brandName","url":"a[href*=\"/p/\"]@href","sku":"@data-sku-id"}}},"params":[{"name":"brandSlug","type":"string","required":true,"description":"Brand slug copied from an actual public Ulta /brand/ link.","example":"olaplex","pattern":"[a-z0-9-]+","hint":"The public brand path segment, without slash or query."}],"readOnly":true,"minTier":1,"learnedLoggedIn":false,"checks":[{"args":{"brandSlug":"redken"},"expect":"result","purpose":"Different brand must return different product identities and labels."},{"args":{"brandSlug":"morphe"},"expect":"result","purpose":"Third public brand link must return its own product cards."}]}},{"hash":"8dc9e347e9b031191ec54c6c1ea6b0fcb9287f681115ff73a995ae4d6d8fe066","status":"live","confirmations":0,"operation":{"name":"listCategoryProducts","description":"Discover products across brands in a public three-level US category document. Returns initial product cards in document order with SKU-bearing detail links; no full-catalog or stock guarantee.","request":{"method":"GET","url":"https://www.ulta.com/shop/%7Bdepartment%7D/%7Bcategory%7D/%7Bsubcategory%7D","headers":{"accept":"text/html,application/xhtml+xml,application/xml;q=0.9,image/jxl,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.7","upgrade-insecure-requests":"1","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/156.0.0.0 Safari/537.36","sec-ch-ua":"\"Not:A-Brand\";v=\"8\", \"Chromium\";v=\"156\", \"Google Chrome\";v=\"156\"","sec-ch-ua-mobile":"?0","sec-ch-ua-platform":"\"macOS\""}},"slots":[{"param":"department","at":["path:1"]},{"param":"category","at":["path:2"]},{"param":"subcategory","at":["path:3"]}],"volatile":[],"trigger":{"url":"https://www.ulta.com/shop/{department}/{category}/{subcategory}"},"match":{"method":"GET","host":"www.ulta.com","path":"/shop/*/*/*"},"response":{"format":"html","contentType":"text/html","html":{"items":".ProductListingResults__productList .ProductListingResults__productCard","fields":{"name":".pal-c-ProductCardBody--title","brand":".pal-c-ProductCardBody--brandName","url":"a[href*=\"/p/\"]@href","sku":"@data-sku-id"}}},"params":[{"name":"department","type":"string","required":true,"description":"The department segment copied in order from a public three-level Ulta /shop/ category link.","example":"makeup","pattern":"[a-z0-9-]+","hint":"Copy this segment from the same /shop/department/category/subcategory link, without slash or query."},{"name":"category","type":"string","required":true,"description":"The category segment copied in order from a public three-level Ulta /shop/ category link.","example":"face","pattern":"[a-z0-9-]+","hint":"Copy this segment from the same /shop/department/category/subcategory link, without slash or query."},{"name":"subcategory","type":"string","required":true,"description":"The subcategory segment copied in order from a public three-level Ulta /shop/ category link.","example":"foundation","pattern":"[a-z0-9-]+","hint":"Copy this segment from the same /shop/department/category/subcategory link, without slash or query."}],"readOnly":true,"minTier":1,"learnedLoggedIn":false,"checks":[{"args":{"department":"skin-care","category":"moisturizers","subcategory":"night-cream"},"expect":"result","purpose":"A different category returns its own products across brands."},{"args":{"department":"hair","category":"shampoo-conditioner","subcategory":"shampoo"},"expect":"result","purpose":"An unseen category from public navigation returns its own products across brands."}]}}]}