Piloterr

Mr.Bricolage Suggest

GET
/v2/mrbricolage/suggest

Live Mr.Bricolage product suggestions for a search keyword or EAN, including title, URL, image, price and currency.

Credit cost: 3 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

Search keyword or EAN used to query the Mr.Bricolage live suggest endpoint. Accepts product names, partial titles or numeric identifiers such as EAN barcodes.

Examples:

marteau
3283988157233

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/mrbricolage/suggest?query=string"
{  "total": 5,  "results": [    {      "url": "https://www.mr-bricolage.fr/marteau-perforateur-rh800-800-w.html",      "type": "product",      "image": "https://media.mr-bricolage.fr/media/catalog/product/cache/3a46d67a25d94f618cdcf20d0c3383a5/3/6/3603745041702_b1_ad04.jpg",      "price": 92.9,      "title": "Marteau perforateur rh800 800 w",      "currency": "EUR"    },    {      "url": "https://www.mr-bricolage.fr/coffret-marteau-burineur-4-burins-pour-compresseur-michelin.html",      "type": "product",      "image": "https://media.mr-bricolage.fr/media/catalog/product/cache/3a46d67a25d94f618cdcf20d0c3383a5/8/0/8020119077245_b1_b661.jpg",      "price": 37.9,      "title": "Coffret marteau burineur 4 burins pour compresseur - MICHELIN",      "currency": "EUR"    },    {      "url": "https://www.mr-bricolage.fr/marteau-burineur-1500w-5-5-joules-v2-inventiv.html",      "type": "product",      "image": "https://media.mr-bricolage.fr/media/catalog/product/cache/3a46d67a25d94f618cdcf20d0c3383a5/3/6/3603745041764_b1_1d3c.jpg",      "price": 92.9,      "title": "Marteau burineur 1500W 5.5 joules V2 - INVENTIV",      "currency": "EUR"    },    {      "url": "https://www.mr-bricolage.fr/combine-marteau-brosse.html",      "type": "product",      "image": "https://media.mr-bricolage.fr/media/catalog/product/cache/3a46d67a25d94f618cdcf20d0c3383a5/3/1/3154020044166_a1_da7a.jpg",      "price": 5.3,      "title": "Combiné marteau brosse",      "currency": "EUR"    },    {      "url": "https://www.mr-bricolage.fr/marteau-a-piquer.html",      "type": "product",      "image": "https://media.mr-bricolage.fr/media/catalog/product/cache/3a46d67a25d94f618cdcf20d0c3383a5/3/1/3154020044159_b1_9145.jpg",      "price": 9.1,      "title": "Marteau à piquer",      "currency": "EUR"    }  ]}
{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}