Ulta Beauty

Ulta Beauty Search API

Search Ulta Beauty products by keyword, 64 per page plus sponsored placements: product id, sku id, brand, name, URL, image, list and sale price in dollars (with the price range when shades are priced differently), discount, promo text, rating, review count, badge, shade or size count and a sponsored flag. Costs 1 credit per request.

POST/api/v1/ulta/search

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

querystringrequired

Search keywords.

Example: 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.search(query="lipstick")["data"]

print(res["total_results"], "results over", res["total_pages"], "pages")
for p in res["products"]:
    print(p["brand"], p["name"], p["list_price"], "sale:", p["sale_price"], p["rating"], p["review_count"])

Response

"query": "lipstick",

"page": 1,

"page_size": 64,

"total_results": 186,

"total_pages": 3,

"count": 73,

"sponsored_count": 14,

"has_more": true,

"response_time": 6589

}