Piloterr

Boulanger Search

GET
/v2/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

Authorization

ApiKeyAuth
x-api-key<token>

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

In: header

Query Parameters

query*string

Keyword, a Boulanger /resultats URL, or a /c/ category URL.

Examples:

aspirateur
https://www.boulanger.com/resultats?tr=aspirateur
https://www.boulanger.com/c/aspirateur

A /ref/ product URL returns 400.

page?number

Page number, from 1. Default is 1. Page 2 is sent as numPage=2 and returns different product ids.

Example: 2

return_page_source?boolean

When true, returns the raw HTML instead of the parsed JSON. The response shape is {"result": "..."}. Default false.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.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  }}
{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}