Sephora Product
GET
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
ApiKeyAuthheader
x-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringA Sephora product URL. A product id such as 831955 also works.
https://www.sephora.fr/p/midnight-espresso---eau-de-parfum-au-cafe-831955.htmlregion?stringShop when query is only an id. Use fr for France or de for Germany. Leave empty for France.
return_page_source?booleanReturn the rendered HTML instead of JSON.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
Default
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
Default
falseSuccessful response
application/json- response
id?stringsku?stringurl?stringname?stringsize?stringbadge?stringbrand?stringprice?integerimages?array<string>rating?numberregion?stringcurrency?stringin_stock?booleanvariants?array<>brand_url?stringmaster_id?stringunit_price?numberreview_count?integerprice_display?stringunit_price_display?stringcurl -X GET 'https://api.piloterr.com/v2/sephora/product?query=string'Example Response
{ "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"}