Ulta Beauty

Ulta Beauty Category API

Products in an Ulta Beauty category such as /shop/makeup/lips/lipstick, 64 per page plus sponsored placements, with the category title and total results. Each product carries the same fields as search: ids, brand, name, URL, image, list and sale price, discount, promo text, rating, review count, badge and shade count. Costs 1 credit per request.

POST/api/v1/ulta/category

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

categorystringrequired

An ulta.com category that lists products: the full URL, or its path (/shop/makeup/lips/lipstick or makeup/lips/lipstick). Landing pages such as /shop/makeup that show no product grid answer 404.

Example: /shop/makeup/lips/lipstick

pageinteger

Results page, 1-based, up to 100. Defaults to 1. 64 products per page, plus sponsored placements.

Example: 1

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.ulta.category(category="/shop/makeup/lips/lipstick")["data"]

print(res["title"], res["total_results"], "products")
for p in res["products"]:
    print(p["position"], p["brand"], p["name"], p["list_price"], p["list_price_range"], p["badge"])

Response

"category": "/shop/makeup/lips/lipstick",

"title": "Lipstick",

"url": "https://www.ulta.com/shop/makeup/lips/lipstick",

"page": 1,

"page_size": 64,

"total_results": 254,

"total_pages": 4,

"count": 70,

"sponsored_count": 14,

"has_more": true,

"response_time": 5461

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.ulta.category(category="/shop/makeup/lips/lipstick")["data"] print(res["title"], res["total_results"], "products") for p in res["products"]: print(p["position"], p["brand"], p["name"], p["list_price"], p["list_price_range"], p["badge"])