Guides

Guides and documentation

Last updated

Practical guides to building lead lists from Google Maps, and the documentation for the MapsData REST API and MCP server.

Guides

  • Is it legal to scrape Google Maps?
    What US law actually says about scraping public Google Maps data, what hiQ v. LinkedIn decided and did not decide, and the rules that apply when you contact the leads.
  • How to get leads from Google Maps
    Three ways to turn Google Maps into a lead list: collect it by hand, build your own scraper, or use a lead tool that finds business emails you can verify. Try it free for 7 days.
  • Every field in a Google Maps lead list
    Every column in a Google Maps lead list from MapsData: email, phone, website, address, rating, reviews, hours and more, with a sample row and how teams use each field.
  • Google Maps business categories, and how to pick them
    How Google Maps business categories work, why regional spellings matter, and how to choose categories for a lead list that reaches the buyers you want.
  • Does the Google Places API return emails?
    No. The Google Places API returns phone numbers and websites but no email field, and Text Search stops at 60 results. What the API gives you and how to get the emails.
  • What Google Maps leads with emails cost
    What a Google Maps lead with an email costs on each MapsData plan, from $0.26 to $1.90 per 1,000, with a calculator and what to compare between lead tools.
  • Google Maps leads in the UK, Canada and Australia
    Build Google Maps lead lists with emails in Canada, the UK and Australia, down to postal areas, plus the spelling differences and outreach rules for each market.

API and MCP documentation

  • MapsData API
    Submit a Google Maps scrape, track it, and download the results over a JSON API. Nine endpoints, bearer auth, and a quickstart you can paste into a terminal.
  • Authentication
    How MapsData API keys work: creating one, the mdk_live_ format, scopes, revoking, and why a key is only ever shown once.
  • Submitting a scrape
    Every field on a scrape submission, why categories and regions are validated against fixed lists, how to validate without spending quota, and how to retry safely.
  • Polling and lifecycle
    The queued to running to completed state machine, how long scrapes really take, how to poll sensibly, and how to download the result.
  • Errors and rate limits
    The full MapsData API error code table with what to do about each, the per-key and per-workspace rate limits, and how to retry well.
  • Connect an AI agent
    MapsData is a remote MCP server, so Claude, Cursor or another AI assistant can find categories, start Google Maps scrapes and fetch the results for you.
  • Build Google Maps lead lists with an AI assistant
    Connect the MapsData MCP server to Claude, Cursor or another AI assistant and ask for Google Maps lead lists with emails in plain language. Included on every paid plan.

Plans and pricing

Every paid plan includes the REST API and the MCP server. See MapsData pricing.

Try it on your own market

Start a 7-day free trial of MapsData Starter with up to 500 Google Maps leads with emails. Card required, cancel before day 7 and you will not be charged.

Start your free trial