Piloterr

Mr.Bricolage Suggest

Live Mr.Bricolage product suggestions for a given keyword and store, including title, URL, image, price and currency.

Credit cost: 3 credits per call

GET
/v2/mrbricolage/suggest

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 used to query the Mr.Bricolage live suggest endpoint. Matches product titles available in the selected store catalog.

Example:

marteau
store_id*string

Mr.Bricolage store identifier (as returned by the Mr.Bricolage Stores Finder endpoint). The suggestions are scoped to the catalog and stock of that store.

Example: S727

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/mrbricolage/suggest?query=string&store_id=string"
{
  "total": 5,
  "results": [
    {
      "type": "product",
      "title": "Marteau perforateur rh800 800 w",
      "url": "https://www.mr-bricolage.fr/Matignon/marteau-perforateur-rh800-800-w.html",
      "image": "https://media.mr-bricolage.fr/media/catalog/product/cache/3a46d67a25d94f618cdcf20d0c3383a5/3/6/3603745041702_b1_ad04.jpg",
      "price": 92.9,
      "currency": "EUR"
    },
    {
      "type": "product",
      "title": "Coffret marteau burineur 4 burins pour compresseur - MICHELIN",
      "url": "https://www.mr-bricolage.fr/Matignon/coffret-marteau-burineur-4-burins-pour-compresseur-michelin.html",
      "image": "https://media.mr-bricolage.fr/media/catalog/product/cache/3a46d67a25d94f618cdcf20d0c3383a5/8/0/8020119077245_b1_b661.jpg",
      "price": 37.9,
      "currency": "EUR"
    },
    {
      "type": "product",
      "title": "Marteau burineur 1500W 5.5 joules V2 - INVENTIV",
      "url": "https://www.mr-bricolage.fr/Matignon/marteau-burineur-1500w-5-5-joules-v2-inventiv.html",
      "image": "https://media.mr-bricolage.fr/media/catalog/product/cache/3a46d67a25d94f618cdcf20d0c3383a5/3/6/3603745041764_b1_1d3c.jpg",
      "price": 92.9,
      "currency": "EUR"
    },
    {
      "type": "product",
      "title": "Combiné marteau brosse",
      "url": "https://www.mr-bricolage.fr/Matignon/combine-marteau-brosse.html",
      "image": "https://media.mr-bricolage.fr/media/catalog/product/cache/3a46d67a25d94f618cdcf20d0c3383a5/3/1/3154020044166_a1_da7a.jpg",
      "price": 5.3,
      "currency": "EUR"
    },
    {
      "type": "product",
      "title": "Marteau à piquer",
      "url": "https://www.mr-bricolage.fr/Matignon/marteau-a-piquer.html",
      "image": "https://media.mr-bricolage.fr/media/catalog/product/cache/3a46d67a25d94f618cdcf20d0c3383a5/3/1/3154020044159_b1_9145.jpg",
      "price": 9.1,
      "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"
}