Piloterr

Boulanger Product

GET
/v2/boulanger/product

Read one Boulanger product from its URL or product id. You get price, brand, rating, seller, and specifications.

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

Product URL /ref/{id}, or the numeric product id.

Examples:

https://www.boulanger.com/ref/1193303
1193303

A keyword or a search URL returns 400.

return_page_source?boolean

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

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
sku?string
url?string
gtin?string
name?string
brand?string
color?unknown
image?string
price?number
images?array<string>
rating?number
seller?string
eco_tax?number
reviews?array<>
currency?string
warranty?string
condition?string
highlight?string
was_price?integer
categories?array<string>
product_id?string
description?string
return_days?integer
return_fees?string
seller_note?string
availability?string
review_count?integer
price_display?string
return_method?string
specifications?array<>
eco_tax_display?string
delivery_options?array<>
discount_display?string
installment_cost?unknown
transit_days_max?integer
transit_days_min?integer
handling_days_max?integer
handling_days_min?integer
installment_count?integer
installment_price?number
shipping_price_max?integer
shipping_price_min?integer
reference_price_label?string
installment_cost_display?unknown
installment_price_display?string
Example Request
curl -X GET 'https://api.piloterr.com/v2/boulanger/product?query=string'
Example Response
{  "sku": "790955ea-031f-4c6a-a06d-a9bdeedec70c",  "url": "https://www.boulanger.com/ref/1193303",  "gtin": "5025155081754",  "name": "Aspirateur balai DYSON V15 Detect Absolute",  "brand": "DYSON",  "color": null,  "image": "https://boulanger.scene7.com/is/image/Boulanger/5025155081754_h_f_l_0",  "price": 709.29,  "images": [    "https://boulanger.scene7.com/is/image/Boulanger/5025155081754_h_f_l_0",    "https://boulanger.scene7.com/is/image/Boulanger/5025155081754_h_f_l_1",    "https://boulanger.scene7.com/is/image/Boulanger/5025155081754_h_f_l_2",    "https://boulanger.scene7.com/is/image/Boulanger/5025155081754_h_f_l_3",    "https://boulanger.scene7.com/is/image/Boulanger/5025155081754_h_f_l_4",    "https://boulanger.scene7.com/is/image/Boulanger/5025155081754_h_f_l_5",    "https://boulanger.scene7.com/is/image/Boulanger/5025155081754_h_f_l_6",    "https://boulanger.scene7.com/is/image/Boulanger/5025155081754_h_f_l_7",    "https://boulanger.scene7.com/is/image/Boulanger/5025155081754_h_f_l_8",    "https://boulanger.scene7.com/is/image/Boulanger/5025155081754_h_r_l_0",    "https://boulanger.scene7.com/is/image/Boulanger/5025155081754_h_r_l_1",    "https://boulanger.scene7.com/is/image/Boulanger/5025155081754_h_b_l_0",    "https://boulanger.scene7.com/is/image/Boulanger/5025155081754_h_b_l_1",    "https://boulanger.scene7.com/is/image/Boulanger/5025155081754_h_z_l_0",    "https://boulanger.scene7.com/is/image/Boulanger/5025155081754_h_z_l_1"  ],  "rating": 4.7,  "seller": "electro network",  "eco_tax": 1.2,  "reviews": [    {      "date": "2026-10-19",      "text": "Tres bon produit, puissant et silencieux, avec une très bonne autonomie de presque 1 heure !! la 2eme brosse avec le laser ... pas vraiment utile, c'est plus un gadget qu'autre chose. Un bon aspirateur, a conseiller :-)",      "title": "DYSON V15",      "author": "Alex Martin",      "rating": 5    },    {      "date": "2026-10-05",      "text": "Très puissant.\\nVraiment top\\nC'est mon quatrième dyson et celui-ci dépasse tous les autres",      "title": "Aspirateur Dyson",      "author": "Jordan Lee",      "rating": 5    },    {      "date": "2026-10-05",      "text": "Je n'ai rien a dire hormis qu'il marche très bien depuis que je l'ai, il est très facile a nettoyer, le filtre et tout le reste s'enlève facilement. Je recommande a 100%",      "title": "Au top",      "author": "Sam Rivera",      "rating": 5    },    {      "date": "2026-10-01",      "text": "contente du produit l'éclairage sur la brosse",      "title": "utilisation",      "author": "Casey Nguyen",      "rating": 5    },    {      "date": "2026-09-27",      "text": "Une aspiration forte idéale pour les pouls de chien \\nLa brosse pour les canapés en tissus pour enlever les pouls de chiens au top la plus efficace de tous les aspirateurs des autres marques type lg ou dreame qui n a ont jamais cette efficacité",      "title": "Excellent",      "author": "Morgan Blake",      "rating": 5    },    {      "date": "2026-09-25",      "text": "Aspire très bien et la lumière sur la brosse permet de voir toutes les petites saletés petit inconvénient un peu lourd;",      "title": "Top",      "author": "Riley Chen",      "rating": 5    },    {      "date": "2026-09-25",      "text": "Très satisfait de cet aspirateur balai Dyson ! Il est puissant, léger et très maniable, ce qui rend le ménage beaucoup plus rapide et agréable. J’apprécie particulièrement son efficacité sur les poussières, les cheveux et les poils d’animaux. La liberté du sans-fil est également un vrai plus au quotidien.\\n\\nUn appareil de qualité, pratique et performant. Je le recommande sans hésiter !",      "title": "Aspirateur balai DYSON V15",      "author": "Taylor Brooks",      "rating": 5    },    {      "date": "2026-09-24",      "text": "Très bon produit. Aspire très bien",      "title": "Top produit",      "author": "Quinn Parker",      "rating": 5    },    {      "date": "2026-09-24",      "text": "Mais il est un peu lourd à utiliser",      "title": "Il marche très bien",      "author": "Avery Kim",      "rating": 5    },    {      "date": "2026-09-18",      "text": "Depuis que je l'ai acheté ma femme me délaisse...",      "title": "Trop bien",      "author": "Drew Patel",      "rating": 5    }  ],  "currency": "EUR",  "warranty": "Garantie légale : 2 ans",  "condition": "neuf",  "highlight": "Sa lumière révèle les particules invisibles à l'oeil nu ! Fourni avec 4 accessoires",  "was_price": 799,  "categories": [    "Maison - Entretien - Jardin",    "Aspirateur",    "Aspirateur balai"  ],  "product_id": "1193303",  "description": "Toute l'innovation Dyson se retrouve dans l'aspirateur-balai V15 Detect Absolute : performance, hygiène et puissance sont les mots-clés de la conception du V15 Detect Absolute. Une technologie de pointe Offrez à votre intérieur un nettoyage impeccable et un air pur grâce à l'aspiration ultra-puissante du moteur numérique Hyperdymium du V15 Detect Absolute. L'aspiration du V15 Detect Absolute et son filtre à particules retiennent et éliminent 99,97% des poussières, pollens et micro-particules. Le balai aspirateur sans fil V15 Detect Absolute est l'appareil idéal pour une maison saine. Doté d'innovations signées Dyson, l'aspirateur-balai V15 Detect Absolute est équipé d'un moteur Hyperdymium qui délivre une puissance d'aspiration allant jusqu'à 125,000 tours par minute. Ce moteur innovant et ultra-performant vous garantit un nettoyage rapide et efficace sur tout type de sol, des parquets les plus fragiles aux moquettes les plus épaisses. Une conception à votre service L'aspirateur-balai V15 Detect Absolute est équipé d'une brosse motorisée intuitive et performante sur toutes les surfaces. Les poils rigides en nylon gainés sont conçus spécialement pour décoller les saletés des moquettes et tapis, tandis qu'une lumière sur la tête éclaire toutes les poussières pour une aspiration et un rendu impeccables. Pensé pour s'intégrer parfaitement à votre quotidien, l'aspirateur-balai V15 Detect Absolute est doté d'une batterie rechargeable longue durée vous permettant une utilisation optimale jusqu'à 60 minutes. Son écran LCD, quant à lui, vous donne une vision en direct de l'autonomie de votre V15 Detect Absolute et vous laisse naviguer parmi les modes Eco, Auto et Boost. Grâce à sa station de chargement 2-en-1, le V15 Detect Absolute se pose partout, se fixe sur un mur ou s'utilise indépendamment. L'exigence Dyson reconnue par le label LONGTIME Cette technologie bénéficie du label LONGTIME®, qui atteste sa conception pour durer bien au-delà des standards classiques. Testé pour résister à plus de 600 cycles de charge, à des milliers de sollicitations sur ses composants clés et à des chutes répétées, il est fabriqué avec des matériaux ultra-résistants et dispose de protections contre la surchauffe, l'humidité et les chocs. Le label LONGTIME® garantit la durabilité, la réparabilité et la disponibilité des pièces détachées, pour un appareil qui vous accompagne efficacement année après année.",  "return_days": 15,  "return_fees": "free",  "seller_note": "Les délais de livraisons peuvent être allongés en période de soldes et de fin d'année.",  "availability": "in_stock",  "review_count": 421,  "price_display": "709,29 €",  "return_method": "in_store",  "specifications": [    {      "name": "Type de sols",      "value": "Carrelages, parquets, tapis, moquettes"    },    {      "name": "Pour quelles surfaces ?",      "value": "Meubles, textiles, hauteurs"    },    {      "name": "Brosse ou Accessoire spécial",      "value": "Brosse motorisée Optic Fluffy dont la lumière permet de mieux voir et sur une plus grande surface la poussière"    },    {      "name": "Et en plus",      "value": "Suceur long pour aspirer des endroits difficiles d'accès (voiture, radiateur,...)"    },    {      "name": "Spécial animaux (brosse motorisée)",      "value": "oui"    },    {      "name": "Brosse principale",      "value": "Brosse Optic Fluffy"    },    {      "name": "Fonction anti-emmêlement",      "value": "oui"    },    {      "name": "Puissance d'aspiration maximale",      "value": "240 airwatts"    },    {      "name": "Qu'est-ce que les Airwatts ?",      "value": "C'est une unité qui mesure l'efficacité des aspirateurs en se réfèrant au débit d'air (m3/s) et à la puissance (watts) qu'un aspirateur produit et utilise."    },    {      "name": "Détail sur la puissance d'aspiration",      "value": "Elle peut varier en fonction du type de sols (parquet, carrelage, tapis, moquette) que vous aspirez et du mode utilisé (standard, éco, boost)"    },    {      "name": "Puissance de la batterie",      "value": "25,2 V"    },    {      "name": "Nombre de batterie",      "value": "1"    },    {      "name": "Aspiration en marche arrière",      "value": "Oui"    },    {      "name": "Autonomie",      "value": "1 h"    },    {      "name": "Temps de charge",      "value": "4 h 30"    },    {      "name": "Niveau sonore jusqu'à",      "value": "0 dB"    },    {      "name": "Poids",      "value": "3,1 kg"    },    {      "name": "Nombre de modes de nettoyage",      "value": "2"    },    {      "name": "Position parking",      "value": "Non"    },    {      "name": "Bouton marche / arrêt",      "value": "Pression continue à maintenir pendant le nettoyage"    },    {      "name": "Station de recharge",      "value": "support de charge à fixer au mur"    },    {      "name": "Capacité du réservoir",      "value": "0,76 L"    },    {      "name": "Type de réservoir à poussière",      "value": "Bac à retirer pour vider la poussière"    },    {      "name": "Aspirateur à main",      "value": "Nécessite d'enlever le tube et d'utiliser les différents accessoires et brosses fournis pour une utilisation d'appoint (ex: table, voiture, fauteuil)"    },    {      "name": "Tube télescopique",      "value": "Non concerné"    },    {      "name": "Tube pliable",      "value": "Non concerné"    },    {      "name": "Système de filtration",      "value": "2 étapes de filtration, les aspirateurs à plusieurs étapes de filtration permetttent d'aspirer jusqu'à 99,99% des particules et allergènes"    },    {      "name": "Entretien du filtre du réservoir",      "value": "Lavable sous l'eau"    },    {      "name": "Suceur long ou extensible",      "value": "Pour aspirer les zones difficiles d'accès : derrière les radiateurs, derrière les meubles, entre les sièges de voiture, ..."    },    {      "name": "Brosse Digital Motorbar",      "value": "Elle s'adapte automatiquement aux différents types de sols pour optimiser le nettoyage et l'autonomie. Sa technologie auto-démêlante enlève automatiquement les cheveux et poils d'animaux du rouleau de la brosse"    },    {      "name": "Support murale de charge",      "value": "Pour recharger et ranger l'appareil et ses accessoires"    },    {      "name": "Brosse Optic Fluffy",      "value": "Brosse faite avec du nylon souple et de la fibre de carbone antistatique pour éliminer plus facilement la poussière des sols durs et espaces étroits. Sa lumière permet de mieux voir et plus loin la poussière dans les zones plus sombres"    },    {      "name": "Dimensions l x h x p",      "value": "26.6 x 126 x 25 cm"    },    {      "name": "Garantie",      "value": "2 ans"    },    {      "name": "Fabriqué en",      "value": "Malaisie"    },    {      "name": "Disponibilité des pièces détachées (données fournisseur)",      "value": "Pendant 13 ans, à compter de la date d'achat"    }  ],  "eco_tax_display": "1,20 €",  "delivery_options": [    {      "label": "Retrait en magasin",      "detail": "indisponible"    },    {      "label": "Livraison à domicile",      "detail": "dès jeudi 05 novembre"    }  ],  "discount_display": "-11%",  "installment_cost": null,  "transit_days_max": 10,  "transit_days_min": 1,  "handling_days_max": 3,  "handling_days_min": 1,  "installment_count": 20,  "installment_price": 41.59,  "shipping_price_max": 49,  "shipping_price_min": 0,  "reference_price_label": "Prix de référence",  "installment_cost_display": null,  "installment_price_display": "41,59 €"}