Sephora Search
Search a European Sephora shop by keyword. Region defaults to France. Page through makeup and skincare cards. The US site is a different page and is not included.
Credit cost: 2 credits per call
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringA product word, for example mascara. Or paste a full Sephora search URL.
region?stringShop code. Use fr for France or de for Germany. Leave empty for France. A full URL picks the shop.
page?numberPage number, starting at 1. Use 2 for the next page of products.
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}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
results?array<>pagination?curl -X GET 'https://api.piloterr.com/v2/sephora/search?query=string'{ "results": [ { "id": "836334", "url": "https://www.sephora.fr/p/vertigo---coffret-vertigo-mascara-836334.html", "name": "Vertigo", "size": "10 ml + 3.9 ml + 3.9 ml", "badge": "Nouveauté", "brand": "ARMANI", "image": "https://media.sephora.eu/content/dam/gdam/europe/digital/pim/published/A/ARMANI/836334/414410-media_swatch-0.jpg?scaleWidth=3840&scaleMode=fit", "price": 95, "rating": 4.7, "region": "fr", "currency": "EUR", "subtitle": "Coffret Vertigo mascara", "review_count": 454, "price_display": "95,00 €", "call_to_action": "Ajouter au panier" } ], "pagination": { "next": "https://www.sephora.fr/recherche/?q=mascara&page=2", "page": 1, "per_page": 24, "total_pages": 9, "total_results": 215 }}