Search a whole area with the Google Maps Leads Scraper
Pick a country, region, county or city and collect every business of a category inside it: the scraper covers the area map window by map window, with smaller windows where places are dense.
Every bar in England, every gas station in Ghana, every gym in Paris: pick the area and the category, and the Google Maps Leads Scraper covers the whole area for you.
Add an area in a few clicks
- Choose By area
In your batch's Tasks card, pick By area.

- Add your categories
Type the kind of business you want (bar, gas station, dentist). Add several if you need: each one is searched over every area.

- Search your areas
Type the name of a country, region, county or city. Each match shows its flag, where it is, and its level (Country, Region, County, City). Pick as many areas as you need.

- Check the map
The map shows the areas you picked, so you see exactly what will be covered.

- Add the tasks and launch
Add tasks adds one task per category and area (2 categories × 2 areas = 4 tasks), listed one line each. Launch the batch as usual.

How the scraper covers an area
A Google Maps search returns a limited list (up to about 330 places), and in a dense city fewer places than there are. So the scraper does not search an area once: it splits it into map windows.
- It starts from a few large windows that cover the area (16 at most), spread over your batch's slots so that they run in parallel.
- When a window holds 5 or more places of your category, it is split into 4 smaller windows, searched in turn. In the densest streets, windows go down to about 100 m wide.
- With Geo Match on (the default), places outside the area are skipped and not billed. Turned off, they are kept too, flagged
no_location_match. - A place found by two windows is collected once.
In our tests on 15 areas (dense city centers, suburbs, countryside, deserts, coastlines), this found 98% of the places that searching every window would find, with about 30% fewer searches.
What you see in the run log

Searching Leicestershire tile by tile: a task starts on its area.Searching tile 52.7732,-1.2050 at zoom 18: one map window is searched. Each window is one page of the run.Skipped 47: outside the area: places beyond the area's border, set aside and not billed.13 places in this tile: 4 smaller tiles queued: a dense window is split.#141 The Mad Hatters Drinks Co.: a place collected.
Areas
Areas come from OpenStreetMap (© OpenStreetMap contributors): countries, regions, counties, cities and some neighborhoods. A city and its county can be separate areas: Leicestershire, for example, leaves out the city of Leicester, which is an area of its own (the hole in the middle on the map above). To cover both, add both. A few big cities only exist as a point in OpenStreetMap (London, for example): their area is an approximate circle around them, marked approx. in the list.
What it costs
An area run is billed like any Google Maps Leads Scraper run: per place collected, plus the add-ons you turn on (see Credits). Places skipped because they are outside the area are not billed.
Through the API
Find an area's id, then add a task with it. The API splits the task into one task per starting window, so that your slots search them in parallel.
curl "https://api.lobstr.io/v1/googlemaps/areas?q=leicestershire" \ -H "Authorization: Token $LOBSTR_API_KEY" curl -X POST "https://api.lobstr.io/v1/tasks" \ -H "Authorization: Token $LOBSTR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"squid": "<squid id>", "tasks": [{"category": "bar", "area_id": 24669}]}'
The other ways to add Google Maps tasks stay available: By location (a category in a city) and By URL (a Google Maps search URL).