Google Maps Scraper API

Start a scrape in one call

Every request authenticates with a Bearer token in the Authorization header. Keys look like mh_live_… and are created from the Integrations tab in your dashboard.

curl -X POST https://api.mapsharvest.com/scrape \
  -H "Authorization: Bearer mh_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "query": "dentist",
    "states": "Florida,Georgia",
    "country": "us",
    "max_total_results": 500,
    "min_rating": 4.0,
    "exclude_website": true
  }'

# → {"job_id":"a7f3c2d1e8b94f56","status":"queued", ... }

That single request scrapes every city in Florida and Georgia for dentists rated 4.0+ with no website — the exact shape of a web-design prospect list.

Endpoints

A complete workflow

Start, poll, download — in Python:

import time, requests

API  = "https://api.mapsharvest.com"
HDRS = {"Authorization": "Bearer mh_live_..."}

# 1. Start
job = requests.post(f"{API}/scrape", headers=HDRS, json={
    "query": "roofing contractor",
    "states": "Texas",
    "max_results_per_city": 60,
    "require_phone": True,
}).json()

# 2. Poll
while True:
    status = requests.get(f"{API}/jobs/{job['job_id']}", headers=HDRS).json()
    if status["status"] in ("completed", "failed", "stopped"):
        break
    time.sleep(5)

# 3. Download
csv = requests.get(
    f"{API}/jobs/{job['job_id']}/download",
    headers=HDRS, params={"fmt": "csv"},
).content
open("leads.csv", "wb").write(csv)

Prefer not to poll? Pass webhook_url on POST /scrape and the finished rows are posted to you — works with Zapier, Make and n8n.

Filter before you spend credits

Filters are applied during the scrape, not after. A business that fails a filter is never written and never billed — so a tightly-filtered job costs far less than scraping broadly and cleaning up afterwards.

Plans and concurrency

One credit equals one lead. Concurrency is capped per plan — both the workers inside a single job and the number of jobs you can run at once.

Exceeding your parallel-job cap returns 429; running out of credits returns 402. See full pricing.

Frequently asked questions