Lead Generation Tools
Tools for starting, monitoring, and reading Google Maps lead-scraping jobs
This domain contains 5 tools for Google Maps-based lead generation. The typical flow: start a job with start_scrape, track it with get_scrape_status, then read the results with list_leads and get_lead.
start_scrape consumes your monthly lead quota, and only one scrape can run at a time per account. Use get_workspace_usage to check your remaining quota.
Tools
start_scrape
Starts a Google Maps lead-scraping job. The job runs asynchronously — poll it with get_scrape_status. It consumes the workspace owner's monthly lead quota and incurs scraping cost. Person-level enrichment options require a Pro or Team plan.
Key parameters:
| Parameter | Type | Required | Purpose |
|---|---|---|---|
workspace_id | string (UUID) | Yes | Workspace ID |
search_terms | array of strings (1–5) | Yes | Search queries, e.g. ["dentist", "dental clinic"] |
country | string | Yes | Country name, e.g. "Turkey" |
country_code | string (2 letters) | No | ISO country code, e.g. "tr" |
city | string | No | City filter |
state | string | No | State/region filter |
language | string | No | Result language, e.g. "en" or "tr" (default "en") |
results_per_term | number (1–6000) | No | Results per search term (default 10) |
place_minimum_stars | enum | No | Minimum rating: all, two, twoAndHalf, three, threeAndHalf, four, fourAndHalf (default all) |
maximum_leads_enrichment_records | number (1–10) | No | Enables person-level enrichment (Pro/Team only) |
leads_enrichment_departments | array of enums | No | Departments to enrich, e.g. sales, marketing, c_suite |
Prompt your AI like this: "Find dental clinics in Ankara, 100 is enough. Only places rated 4 stars or above."
get_scrape_status
Returns the current status of one scrape job (pending, running, completed, failed) with its result count. Poll this after start_scrape.
Key parameters:
| Parameter | Type | Required | Purpose |
|---|---|---|---|
workspace_id | string (UUID) | Yes | Workspace ID |
scrape_job_id | string (UUID) | Yes | The job ID returned by start_scrape |
Prompt your AI like this: "Is the scrape we started earlier done yet? Check its status."
list_scrape_jobs
Lists a workspace's recent lead-scraping jobs with status and result counts.
Key parameters:
| Parameter | Type | Required | Purpose |
|---|---|---|---|
workspace_id | string (UUID) | Yes | Workspace ID |
status | enum | No | pending, running, completed, failed |
limit | number (1–200) | No | Max rows to return (default 50) |
offset | number | No | Rows to skip (pagination) |
Prompt your AI like this: "Show my recent scrape jobs and how many results each brought in."
list_leads
Paginated lead list for a workspace (scraped Google Maps places). Filters: free-text search on business name, city, category, has-email, and favorites. Archived leads are excluded unless include_archived is set.
Key parameters:
| Parameter | Type | Required | Purpose |
|---|---|---|---|
workspace_id | string (UUID) | Yes | Workspace ID |
search | string | No | Matches the business name |
city | string | No | City filter |
category | string | No | Category filter |
has_email | boolean | No | Only leads with at least one email |
favorites_only | boolean | No | Favorites only |
include_archived | boolean | No | Include archived leads (default false) |
limit / offset | number | No | Pagination (limit defaults to 50, max 200) |
Prompt your AI like this: "List my Ankara leads that have an email address."
get_lead
Returns the full detail of a single lead: contact info, social profiles, scores, enrichment data, and workspace-level status fields.
Key parameters:
| Parameter | Type | Required | Purpose |
|---|---|---|---|
workspace_id | string (UUID) | Yes | Workspace ID |
lead_id | string | Yes | Lead row ID (as returned by list_leads) |
Prompt your AI like this: "Show me everything you have on the 'Dentalya Clinic' lead."
To update lead notes and statuses, see Data Pool Tools. To move a lead into the CRM, see promote_lead_to_crm in CRM Write Tools.