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
headerx-api-key<token>

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

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
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

Response Body

Successful response

application/json
  1. response
total?integer
results?array<>
Example Request
curl -X GET 'https://api.piloterr.com/v2/mrbricolage/suggest?query=string'
Example Response
{  "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"    }  ]}