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

Autorisierung

ApiKeyAuth
headerx-api-key<token>

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

Abfrageparameter

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.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Antworttext

Successful response

application/json
  1. response
id?string
sku?string
url?string
name?string
size?string
badge?string
brand?string
price?integer
images?array<string>
rating?number
region?string
currency?string
in_stock?boolean
variants?array<>
brand_url?string
master_id?string
unit_price?number
review_count?integer
price_display?string
unit_price_display?string
Example Request
curl -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"}