Piloterr

Sephora Product

GET
/v2/sephora/product

Read one European Sephora product by id or product URL. Set region when you are not on the French shop.

Credit cost: 2 credits per call

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

A Sephora product URL. A product id such as 831955 also works.

https://www.sephora.fr/p/midnight-espresso---eau-de-parfum-au-cafe-831955.html
region?string

Shop when query is only an id. Use fr for France or de for Germany. Leave empty for France.

return_page_source?boolean

Return the rendered HTML instead of JSON.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/sephora/product?query=string"
{  "id": "831955",  "sku": "831955",  "url": "https://www.sephora.fr/p/midnight-espresso---eau-de-parfum-au-cafe-831955.html",  "name": "Midnight Espresso - Eau de Parfum",  "size": "75 ml",  "badge": "Nouveauté",  "brand": "KILIAN PARIS",  "price": 145,  "images": [    "https://media.sephora.eu/content/dam/gdam/europe/digital/pim/published/K/KILIAN_PARIS/831955/410806-media_swatch-0.jpg?scaleWidth=750&scaleHeight=750&scaleMode=fit"  ],  "rating": 4.6,  "region": "fr",  "currency": "EUR",  "in_stock": true,  "variants": [    {      "sku": "831955",      "url": "https://www.sephora.fr/p/midnight-espresso---eau-de-parfum-au-cafe-831955.html",      "name": "Midnight Espresso - Eau de Parfum - 75 ml",      "size": "75 ml",      "price": 145,      "currency": "EUR",      "in_stock": true,      "selected": true,      "price_display": "145,00 €"    }  ],  "brand_url": "https://www.sephora.fr/marques/de-a-a-z/kilian-paris-kilia/",  "master_id": "P1000215059",  "unit_price": 193.33,  "review_count": 237,  "price_display": "145,00 €",  "unit_price_display": "193,33 € / 100ml"}
{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}