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
Autorização
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Parâmetros de consulta
query*string
A product word, for example mascara. Or paste a full Sephora search URL.
region?string
Shop code. Use fr for France or de for Germany. Leave empty for France. A full URL picks the shop.
page?number
Page number, starting at 1. Use 2 for the next page of products.
return_page_source?boolean
Return the rendered HTML instead of JSON.
Corpo da resposta
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.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 }}{ "error": "Bad Request"}{ "error": "Invalid API Key"}{ "error": "Payment required"}{ "error": "Rate limit exceeded for the API key: quota monthly"}{ "error": "Internal Error"}