Sephora

Sephora Product API

One sephora.com (US) product by URL or product id: name, brand, rating, review count, loves count, price range, description, suggested usage, category and breadcrumbs, a summary of what reviews say with pro and con sentiment counts, and every shade or size the page offers as a sku with its own price, list and sale price, stock flags, ingredients, images, swatch, and pickup and same-day eligibility. No individual review text. Costs 1 credit per request.

POST/api/v1/sephora/product

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

urlstring

sephora.com product URL (the url of a search or category result). Preferred over product_id: it answers faster.

Example: https://www.sephora.com/product/mac-cosmetics-m-a-cximal-silky-matte-lipstick-P510799

product_idstring

Sephora product id (the product_id of a search or category result). Used when url is not given. One of url or product_id is required.

Example: P510799

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

p = client.sephora.product(url="https://www.sephora.com/product/mac-cosmetics-m-a-cximal-silky-matte-lipstick-P510799")["data"]

print(p["brand"], p["name"], p["rating"], p["review_count"], p["price_min"], "-", p["price_max"])
print(p["review_summary"])
for s in p["skus"]:
    print(s["sku_id"], s["variation_value"], s["size"], s["price"], "in stock" if s["in_stock"] else "out of stock")

Response

"product_id": "P510799",

"name": "M·A·Cximal Silky Matte 12HR Wear Lipstick",

"brand": "MAC Cosmetics",

"brand_url": "https://www.sephora.com/brand/mac-cosmetics",

"url": "https://www.sephora.com/product/mac-cosmetics-m-a-cximal-silky-matte-lipstick-P510799",

"rating": 4.5879,

"review_count": 774,

"loves_count": 316704,

"price_min": 16,

"price_max": 25,

"description": "What it is: A silky matte lipstick with up to 12-hour, full-coverage color and up to eight-hour moisture in a creamy formula that conditions and nourishes lips. Benefits: Hydrating, Long-wearing Highlighted Ingredients: - Coconut Oil, Shea Butter, and Cocoa Butter: Condition and nourish lips. Ingredient Callouts: Free of parabens. What Else You Need to Know: This iconic matte lipstick delivers bold pigment with a creamy texture and a silky matte finish. It wears comfortably for up to 12 hours without flaking, caking, or feathering. Lips feel soft and look visibly fuller with up to eight hours of moisture. Clinical Results: In consumer testing on 120 women, after using product for 1 week: - 98% said this lipstick feels comfortable throughout wear - 95% said this lipstick provides high-impact color throughout wear In consumer testing on 109 women, after using product for 1 week: - 96% said this lipstick leaves lips feeling soft/smooth",

"suggested_usage": "Suggested Usage: -Apply lipstick directly to lips. Pro tips: -Define lips with Lip Liner Pencil or layer on Lipglass Lip Gloss (each sold separately) for a high-shine finish. -Dab lipstick on cheeks for a monochromatic pop of color.",

"review_summary": "Reviews generally reflect favorable impressions of the pigment, texture, and finish, with these features often mentioned positively. Some customers note mild concerns about dryness, transfer, and formula change, though these are less frequently discussed.",

"variation_type": "Color",

"sku_count": 31,

"response_time": 3465

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") p = client.sephora.product(url="https://www.sephora.com/product/mac-cosmetics-m-a-cximal-silky-matte-lipstick-P510799")["data"] print(p["brand"], p["name"], p["rating"], p["review_count"], p["price_min"], "-", p["price_max"]) print(p["review_summary"]) for s in p["skus"]: print(s["sku_id"], s["variation_value"], s["size"], s["price"], "in stock" if s["in_stock"] else "out of stock")