Skip to main content
Piloterr
Back to library

Mr.Bricolage Stores Finder API

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

ActiveFreeGET/v2/finder/mrbricolage-stores

Endpoint Overview

Detailed documentation, pricing, and usage examples.

OverviewLink to Overview

The Mr.Bricolage Stores Finder endpoint allows you to search for Piloterr-supported Mr.Bricolage stores in France and overseas territories. It returns an array of stores with their unique identifiers, contact information and geolocation. This endpoint is free to use and is ideal for resolving a Mr.Bricolage store before calling the Mr.Bricolage Suggest or Product APIs with a store_id or store_slug.

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/finder/mrbricolage-stores?query=matignon

ParametersLink to Parameters

Parameter Type Required Description
query string yes Case-insensitive string to filter store names, cities or postal codes

Response fieldsLink to Response fields

Field Type Description
id string Unique internal store identifier
store_id string Mr.Bricolage store ID, usable in the Mr.Bricolage Suggest API
store_slug string URL slug of the store on www.mr-bricolage.fr, usable in the Mr.Bricolage Suggest API
magento_slug string Magento URL slug used internally by Mr.Bricolage
seo_id string Numeric SEO identifier of the store
name string Store name
city string Store city
postal_code string Store postal code
country_code string ISO country code (FR, MU, etc.)
region string Region the store belongs to (e.g. Bretagne)
department string French department name (e.g. Côtes-d'Armor)
phone string Store phone number in international format
epj string EPJ accounting identifier of the store
live_page_url string Public URL of the store locator page

NotesLink to Notes

  • Both store_id and store_slug can be passed to the Mr.Bricolage Suggest API; you only need to provide one
  • Stores cover Metropolitan France and overseas territories (Guadeloupe, Martinique, Guyane, Réunion, Mayotte, Mauritius)
  • The search is case-insensitive

Main use casesLink to Main use cases

  • Locate the nearest Mr.Bricolage store by city name before fetching local suggestions or products
  • Resolve store names to IDs or slugs for use in the Mr.Bricolage Suggest API
  • Build store locator features for French DIY retail applications
  • Enrich datasets with Mr.Bricolage store geolocation, contact details and identifiers

Related APIs

Expand your data capabilities with these complementary tools.

Ready to get started?

Your web scraping API is one click away. Start with +500 credits, no infrastructure to set up, no proxies to manage, and no credit card required.

  • +500 credits
  • No credit card required
  • All endpoints included