Local lead generation
Kaan Ersoy1 min read
Who runs this, and what for
| Team | What they decide with it |
|---|---|
| Agencies and B2B sales teams | Which local businesses to call, with a list that has phones and websites already. |
| Vertical SaaS companies | How many prospects a region holds, and which have no website or few reviews. |
| Marketplaces | Which providers to invite onto the platform, city by city. |
The calls, step by step
1. Search each category and city
One Maps search scrolls the results list and returns every place it loaded, usually 20 to 70, with the phone, website, address, category, rating, and review count. place_id identifies each business across searches.

The page on google.com that this call reads, as a signed-out visitor sees it. The response below is what Clair returns from it. GET /v1/google-maps/search?q=plumbers+in+Denver&country=us · results.0
{ "position": 1, "title": "Applewood Plumbing Heating & Electric", "place_id": "ChIJkWUJx22Ha4cRVVLq4AJk7Ng", "data_id": "0x876b876dc7096591:0xd8ec6402e0ea5255", "cid": "15630978370222314069", "latitude": 39.7583004, "longitude": -105.0512657, "rating": 4.8, "reviews_count": 17793, "category": "Plumber", "price": null, "address": "5000 W 29th Ave", "open_state": "Open · Closes 10 PM", "phone": "(303) 444-1633", "website": "https://www.applewoodfixit.com/", "description": null, "wheelchair_accessible": null, "action_links": [ { "label": "Book online", "url": "https://book.servicetitan.com/lhxa271djh03w5bfje81s0qd" } ], "thumbnail": null, "sponsored": false, "url": "https://www.google.com/maps/place/?q=place_id:ChIJkWUJx22Ha4cRVVLq4AJk7Ng" }Recorded response. Live values differ. 2. Deduplicate and filter
Neighbouring cities return some of the same businesses, and sponsored listings repeat organic ones. Keep one row per place_id, drop sponsored, and filter on category, rating, or whether there is a website.
GET /v1/google-maps/search?q=plumbers+in+Denver&country=us · results.0.place_id
"ChIJkWUJx22Ha4cRVVLq4AJk7Ng"Recorded response. Live values differ.
A script to start from
local_leads.py
# Local lead list: every business Google Maps lists for a category in each
# city, with its phone, website, and rating.
import csv, os, requests
API = "https://api.clair.im"
HEADERS = {"Authorization": f"Bearer {os.environ['CLAIR_API_KEY']}"}
CATEGORY = "plumbers"
CITIES = ["Denver, CO", "Aurora, CO", "Boulder, CO"]
def get(path, **params):
r = requests.get(f"{API}{path}", headers=HEADERS, timeout=120, params=params)
r.raise_for_status()
return r.json()
seen = set()
with open("leads.csv", "w", newline="") as f:
out = csv.writer(f)
out.writerow(["name", "category", "phone", "website", "address",
"rating", "reviews", "place_id"])
for city in CITIES:
body = get("/v1/google-maps/search", q=f"{CATEGORY} in {city}")
for p in body["results"]:
if p["place_id"] in seen or p["sponsored"]:
continue # neighbouring cities overlap; ads repeat organic listings
seen.add(p["place_id"])
out.writerow([p["title"], p["category"], p["phone"], p["website"],
p["address"], p["rating"], p["reviews_count"], p["place_id"]])
Set CLAIR_API_KEY to your Clair key; one plan covers the Google Maps API. Each call spends that API's rate from the plan's monthly balance.
What it costs per month
| Schedule | Requests | Plan | Per month | Per 1,000 |
|---|---|---|---|---|
| 1 category × 20 citiesOne search per city = 20 requests. | 20 | Starter | $30 | $1,500 |
| 5 categories × 50 cities5 × 50 = 250 searches. | 250 | Starter | $30 | $120 |
| 5 categories × 200 cities5 × 200 = 1,000 searches. | 1,000 | Starter | $30 | $30 |
What to plan for
- A Maps search covers the area the map shows. For a large city, split it by neighbourhood, or pass latitude, longitude, and zoom for each part.
- Google sometimes gives signed-out visitors a limited view of a place. Search results still have phone and website; place details may be missing, and place.view says so.
- Check the rules for cold outreach where you sell. Published business contacts are still personal data in some jurisdictions.
Common questions
How many businesses does one search return?
Every place the Maps list loaded, usually 20 to 70. Google stops loading more at some point, so a dense category in a big city needs several smaller searches.
Why not use Google's Places API?
You can: it is official and has a free monthly allowance. It returns at most 20 places per page and charges more for phone and website fields; the Google Places comparison has the numbers.

Glassdoor API
Crunchbase API
Instagram API
Bloomberg API
Associated Press API