Sephora

Sephora Search API

Search sephora.com (US) products, 60 per page, and get product id, sku id, brand, name, URL, image, price, list price and sale price in dollars, a price range when sizes are priced differently, value price for sets, rating, review count, extra colors, sale scope, and bestseller, new, Sephora-exclusive, online-only, limited-edition and sponsored flags. Also returns category facets with product counts and related searches. Prices are the sephora.com online prices. Pass zip for same-day delivery eligibility to that ZIP. Costs 1 credit per request.

POST/api/v1/sephora/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. Defaults to 1. 60 products per page.

Example: 1

sortstring

relevance (default), best_selling, rating, price_low, price_high or newest.

zipstring

US ZIP code. When set, each product carries same_day_eligible for same-day delivery to that ZIP. It does not change prices.

Example: 10001

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.sephora.search(query="lipstick", zip="10001")["data"]

for p in res["products"]:
    print(p["product_id"], p["brand"], p["name"], p["price"], p["price_text"], p["rating"], p["review_count"])

Response

"query": "lipstick",

"page": 1,

"sort": "relevance",

"zip": "10001",

"total_results": 169,

"total_pages": 3,

"count": 60,

"response_time": 2982

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.sephora.search(query="lipstick", zip="10001")["data"] for p in res["products"]: print(p["product_id"], p["brand"], p["name"], p["price"], p["price_text"], p["rating"], p["review_count"])