Piloterr

Mr.Bricolage Stores Finder

GET
/v2/finder/mrbricolage-stores

Search Mr.Bricolage stores by name, city or postal code to retrieve their store ID, slug, contact information and geolocation.

Authorization

ApiKeyAuth
headerx-api-key<token>

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

Query Parameters

query*string

Filters Mr.Bricolage stores based on a search string. The search is non-case-sensitive and matches store names, cities and postal codes.

Example:

matignon
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
[index: integer]?
Example Request
curl -X GET 'https://api.piloterr.com/v2/finder/mrbricolage-stores?query=string'
Example Response
[  {    "id": "58cbe9720cb81d1100996836",    "epj": "00794246",    "city": "MATIGNON",    "name": "Mr.Bricolage Matignon",    "phone": "+33 2 96 41 16 94",    "region": "Bretagne",    "seo_id": "137",    "store_id": "S727",    "department": "Côtes-d'Armor",    "store_slug": "Matignon",    "postal_code": "22550",    "country_code": "FR",    "magento_slug": "mr-bricolage-matignon",    "live_page_url": "https://magasin.mr-bricolage.fr/137-mr-bricolage-matignon"  }]