Boulanger Search
Search Boulanger by keyword and page the product grid. Cards include price, brand, seller, and the product URL.
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*stringKeyword, a Boulanger /resultats URL, or a /c/ category URL.
Examples:
aspirateurhttps://www.boulanger.com/resultats?tr=aspirateurhttps://www.boulanger.com/c/aspirateurA /ref/ product URL returns 400.
page?numberPage number, from 1. Default is 1. Page 2 is sent as numPage=2 and returns different product ids.
Example: 2
return_page_source?booleanWhen true, returns the raw HTML instead of the parsed JSON. The response shape is {"result": "..."}. Default false.
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/boulanger/search?query=string'{ "results": [ { "url": "https://www.boulanger.com/ref/9000978984", "name": "Aspirateur balai VACTIDY V10 PRO", "brand": "VACTIDY", "color": null, "image": "https://boulanger.scene7.com/is/image/Boulanger/6924843236393_h_f_l_0", "price": 66.99, "rating": null, "seller": "Vactidy France", "eco_tax": null, "currency": "EUR", "in_stock": true, "offer_id": "86dc761c-d394-4c82-bb0d-345b89258dd7", "position": 1, "condition": "neuf", "highlight": "Le design moderne rose et le format sans fil léger apportent une touche de plaisir au quotidien, pour un nettoyage simple et fluide.", "was_price": 89.99, "key_points": [ "Temps de charge : 4 h, Autonomie : 45 mn, Poids : 2,2 kg", "Tube pliable : Non concerné", "Note de l'indice de réparabilité (sur 10) : 9.5, Station de recharge intégrée au support mural", "On adore : Le design moderne rose et le format sans fil léger apportent une touche de plaisir au quotidien, pour un nettoyage simple et fluide." ], "product_id": "9000978984", "review_count": null, "price_display": "66,99 €", "eco_tax_display": null, "discount_display": "-25%", "installment_cost": null, "installment_count": null, "installment_price": null, "installment_cost_display": null, "installment_price_display": null } ], "pagination": { "next": "https://www.boulanger.com/resultats?tr=aspirateur&numPage=2", "page": 1, "per_page": 40, "total_pages": 23, "total_results": 916 }}