MCP + API · kestrel/google-maps-scraper
Google Maps Scraper — Leads, Emails, Phone Numbers & Contacts
Google Maps places and business leads by keyword and location: phone, website, rating, hours, place ID. Optional website emails and social links. Email-only mode bills only delivered places with emails. Count after free filters: no website, low rated, unclaimed. Newly seen place monitoring.
Open Actor Download MCP config
Connect this tool
Add this URL as a remote MCP server in your client, then sign in to Apify. For a client-specific setup, use Apify's configurator.
https://mcp.apify.com?tools=call-actor,fetch-actor-details,kestrel/google-maps-scraper
Generic MCP client configuration
{
"mcpServers": {
"kestrel-google-maps-scraper": {
"url": "https://mcp.apify.com?tools=call-actor,fetch-actor-details,kestrel/google-maps-scraper"
}
}
}
Understand the output before you run
Two row types share one dataset: place (one Google Maps place, charged) and status (one per search, free).
Declared dataset fields and row types · Output locations and dataset links
Use the declared dataset schema for item fields; the output schema describes where results are stored. Optional fields may be null or absent. If an integration shows a sampled schema without an optional field, check this declaration, the Actor instructions and actual returned rows before concluding that the field is unsupported.
Inspect 74 declared output fields
| Field | Type | Meaning |
|---|---|---|
type | string | Row type: place (charged) or status (one per search, free). |
search_term | string / null | The search term that returned this place (null for a pasted place). |
search_location | string / null | The location the term was searched in, as you typed it. |
rank | integer / null | Position in Google Maps' result list for that search, 1 = first. |
place_id | string / null | Google place id (ChIJ…), stable across time and the key used for de-duplication and only-new monitoring. |
cid | string / null | Google customer id — the number in maps.google.com/?cid=… links. |
feature_id | string / null | Google Maps feature id (0x…:0x…). |
google_maps_url | string / null | Link that opens this place on Google Maps. |
name | string / null | Business name as listed. |
category | string / null | Primary Google category, in the requested language. |
categories | array / null | Every Google category of the place. |
address | string / null | Full address on one line. |
street | string / null | Street and number. |
city | string / null | City or town. |
state | string / null | State, province or region when Google gives one. |
postal_code | string / null | Postal or ZIP code. |
country_code | string / null | Two-letter country code. |
neighborhood | string / null | Neighbourhood or district when Google gives one. |
plus_code | string / null | Global plus code (Open Location Code) of the coordinates. |
lat | number / null | Latitude. |
lng | number / null | Longitude. |
distance_km_from_center | number / null | Kilometres from the centre of the searched location or area. |
phone | string / null | Phone number in local format. |
phone_international | string / null | Phone number in international format (+1 512-…). |
website | string / null | Website listed on Google Maps. |
domain | string / null | Website host without www. |
rating | number / null | Average star rating, 1.0–5.0. Null when the place has no reviews. |
review_count | integer / null | Number of Google reviews (0 when there are none). |
reviews_per_star | object / null | Reviews by star: {"1": n, …, "5": n}. |
price_level | string / null | Price level when Google shows one for the place. |
is_closed_permanently | boolean / null | True when Google marks the place permanently closed. |
is_closed_temporarily | boolean / null | True when Google marks the place temporarily closed. |
is_claimed | boolean / null | True when the listing has an owner, false when Google offers "Claim this business", null when unknown. |
opening_hours | object / null | Opening hours per day: {"monday": "8 AM–5 PM", …} in the requested language. |
open_now | boolean / null | Whether the place was open when the row was fetched. |
description | string / null | Google's short description of the place. |
attributes | array / null | Attributes Google lists as present: accessibility, amenities, service options … |
menu_url | string / null | Menu link when present. |
booking_url | string / null | Reservation or appointment link when present. |
image_url | string / null | Cover photo. |
photo_count | integer / null | Number of photos Google reports (a lower bound: Google prints "870+"). |
timezone | string / null | IANA timezone of the place. |
emails | array / null | Enrichment: emails read off the place's own website, each {email, type: named|role, source_url}. Addresses on somebody else's domain that are not a mailto link (the web agency, a booking widget) are left out. |
email_primary | string / null | Enrichment: the best address — on the website's own domain and from a mailto link first. |
phones_from_site | array / null | Enrichment: phone numbers from tel: links on the website. |
contact_page_url | string / null | Enrichment: the contact page that was read. |
facebook | string / null | Enrichment: Facebook page. |
instagram | string / null | Enrichment: Instagram profile. |
linkedin | string / null | Enrichment: LinkedIn page. |
x | string / null | Enrichment: X / Twitter profile. |
youtube | string / null | Enrichment: YouTube channel. |
tiktok | string / null | Enrichment: TikTok profile. |
whatsapp | string / null | Enrichment: WhatsApp number from a wa.me or click-to-chat link. |
enrichment_status | string / null | Enrichment: found (charged) | none_found | no_website | social_only | blocked_by_robots | site_unreachable | spending_limit_reached — only "found" is charged. |
has_website | boolean / null | Lead helper: the place lists a website. |
has_email | boolean / null | Lead helper: enrichment found an email (null when enrichment is off). |
lead_flags | array / null | Lead helper: any of no_website, low_rating (< 4.0), few_reviews (< 10), unclaimed. |
target | string / null | Status rows: the pasted URL or id this row accounts for. |
status | string / null | Status rows: ok | no_results | unknown_location | error. |
requested | integer / null | Status rows: places asked for. |
found | integer / null | Status rows: distinct places Google returned. |
filtered | integer / null | Status rows: places your filters removed (free). |
filtered_by | object / null | Status rows: how many each filter removed. |
duplicates | integer / null | Status rows: places already delivered by another search in this run (free). |
already_seen | integer / null | Status rows: places an earlier monitored run delivered (free). |
delivered | integer / null | Status rows: place rows delivered for this search. |
charged | integer / null | Status rows: place events charged for this search — always equal to delivered. |
contacts_found | integer / null | Status rows: contact-found events charged for this search. |
pages | integer / null | Status rows: result pages read. |
grid_cells | integer / null | Status rows: grid cells searched when full coverage is on. |
coverage_note | string / null | Status rows: set when Google's per-query limit was reached and full coverage would find more. |
note | string / null | Status rows: anything the search had to do differently, for example searching around a looked-up town centre. |
error | string / null | Status rows: why the search failed, null when it did not. A throttled or blocked page lands here, never as an empty result. |
fetched_at | string / null | UTC timestamp when the row was fetched. |
Start with a small sample
Use call-actor with the JSON below. The $0.25 run ceiling is separate from the Actor input and may stop the sample early. Change the target to match your request. This input validates against build 1.3.3; it is not a promise that the source has matching rows today.
{
"actor": "kestrel/google-maps-scraper",
"input": {
"searches": [
"coffee shop"
],
"locations": [
"Austin, TX"
],
"maxPlacesPerSearch": 3
},
"callOptions": {
"maxTotalChargeUsd": 0.25,
"timeout": 300
},
"waitSecs": 30
}
After completion, use get-dataset-items with storages.datasets.default.id. If still running, poll get-actor-run using the returned runId. Check status rows and errors before treating an empty dataset as no matches.
Call from Python, JavaScript or REST
Python SDK 3 example · JavaScript SDK 2 example · curl + jq example. Each uses this same small input, reads APIFY_TOKEN from your environment, sets a five-minute run timeout and exports all dataset row types as JSON Lines. The $0.25 run ceiling is separate from the Actor input and may stop the sample early. Inspect the run and source status before treating results as complete. Installation and usage.
Pricing and limits
Current listed event prices in USD. Some Actors charge for successful source checks even when no output rows match. The event descriptions below define those differences.
| Event | USD each | What is charged |
|---|---|---|
place | $0.004 | One Google Maps place delivered as a full row, every detail included: phone, website, rating, review count, hours, address parts, coordinates (row keys place_id, cid, google_maps_url, name, category, phone, website, rating, review_count, opening_hours, address, street, city, postal_code, country_code, lat, lng, is_closed_permanently). $4 per 1,000 places. All filters are free and run BEFORE this charge: places your filters reject, duplicates, places an earlier monitored run delivered, empty or failed searches and unknown locations cost $0. No start fee, proxy and compute included in the event price; charged count always equals delivered rows. The run stops at the maximum cost per run you set when starting it (Apify run option maxTotalChargeUsd), never above it. |
contact-found | $0.003 | When enrichContacts (or onlyWithEmail) is on: $3 per 1,000 places where an email or social/WhatsApp link is found on the place's own website, in addition to the $4 per 1,000 base place fee (row keys emails, email_primary, phones_from_site, contact_page_url, facebook, instagram, linkedin, x, youtube, tiktok, whatsapp, enrichment_status). No website, unreachable website, phone-only findings or no contact found = no contact fee. At the historical 50% contact yield, 1,000 enriched places cost about $5.50 total ($4 base + $1.50 contacts); yield is not guaranteed. With onlyWithEmail, each delivered place has an email and costs $0.007 total: 50 delivered places cost $0.35; places without an email are omitted and free. Proxy and compute are included in these event prices. |
Contracts for agents
- Input schema and sample input
- Prepared MCP call and pricing events
- Full Actor instructions and limits
- REST API
Public contract checked 2026-11-11. Active build: 1.3.3. Refresh live details before a large or recurring run.