Sephora

Sephora Category API

Products in a sephora.com (US) category, 60 per page, in the same shape as search, plus the category's id, name and URL, total product count, parent category, subcategories with product counts and breadcrumbs. Pass the name from a sephora.com/shop/ URL (lipstick, face-serum, makeup-cosmetics) or the full URL. Prices are the sephora.com online prices. Costs 1 credit per request.

POST/api/v1/sephora/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

Category name as it appears in a sephora.com/shop/ URL (lipstick, face-serum, makeup-cosmetics), or the full https://www.sephora.com/shop/... URL.

Example: lipstick

pageinteger

Results page, 1-based. Defaults to 1. 60 products per page.

Example: 1

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.sephora.category(category="lipstick")["data"]

print(res["category"]["name"], res["total_results"], "products")
for p in res["products"]:
    print(p["position"], p["brand"], p["name"], p["price"], "on sale" if p["on_sale"] else "")

Response

"page": 1,

"total_results": 153,

"total_pages": 3,

"count": 60,

"subcategories": [],

"response_time": 3879

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.sephora.category(category="lipstick")["data"] print(res["category"]["name"], res["total_results"], "products") for p in res["products"]: print(p["position"], p["brand"], p["name"], p["price"], "on sale" if p["on_sale"] else "")