FAQ

Questions, answered.

34 answers covering everything from getting started to API access.

Getting started

Do I need a credit card to sign up?+

No. You get 50 free credits the moment you create an account — no credit card, no trial period, no catch. Add payment details only when you're ready to upgrade.

How long does it take to get my first lead list?+

Most users have their first CSV in under 5 minutes. Sign up, pick a business category, select your states, hit start, download. There's nothing to install and no configuration required.

Do I need to install anything?+

Nothing at all. MapsHarvest runs entirely in your browser — no Chrome extensions, no desktop app, no proxies, no code. It works on any device with a modern browser.

What's a credit?+

One credit = one scraped lead. If a scrape returns 500 businesses, it costs 500 credits. Simple. You can see the estimated cost before you start any scrape.

How do I know how many credits a scrape will use?+

The dashboard shows an estimated credit cost before you hit start, based on the number of cities you've selected and an average of ~10 leads per city. The actual usage may vary slightly depending on how many businesses Google returns in each location.

Data & quality

Is scraping Google Maps legal?+

Yes — we only collect publicly visible business listing data from Google Maps. Business names, phone numbers, addresses, and ratings are all publicly listed. We don't collect private user data, reviews, or any personal consumer information. Always use scraped data responsibly and in compliance with CAN-SPAM, GDPR, and any applicable outreach laws in your region.

How fresh is the data?+

Every scrape pulls data live from Google Maps in real time. There is no pre-built database to go stale — results are always as current as Google's listings at the moment you run the scrape. If a business updated their phone number yesterday, you'll get the updated number.

What data fields do I get per lead?+

Up to 18 fields: Business Name, Category, Phone Number, Website URL, Website Domain, Full Address, City, State, Rating, Review Count, Google Maps URL, Plus Code, Hours, Price Level, Temporarily Closed status, Description, Search Query, and Scraped At timestamp. Not every business has all fields populated — that depends on what the business has listed on Google Maps.

Do you get email addresses?+

Not yet — email enrichment is on the roadmap as an optional add-on. For now you get phone number, website URL, and all 18 Google Maps fields, which is everything most cold callers and sales teams need to qualify and contact a lead.

How many leads can I expect per scrape?+

It depends on the niche and the geography. Most scrapes return 10–60 businesses per city. Scraping all of Florida for dental clinics can return 2,000+ leads. Scraping a smaller niche in a rural state might return 200. You can preview the estimated credit cost and city count before starting.

Are there duplicate leads in the export?+

We deduplicate results automatically. If the same business appears in multiple city searches (common near city borders), it's only included once in your final export.

What export formats do you support?+

CSV, XLSX (Excel), and JSON. CSV and XLSX are UTF-8 with BOM so they open cleanly in Excel, Google Sheets, and most auto-dialers without any formatting work. JSON is for developers who want to pipe the data into another tool or API.

Coverage & geography

What US states and cities do you cover?+

All 50 US states, Washington DC, and Puerto Rico — over 30,000 cities and towns in total. When you pick a state, we automatically loop through every city. You can also narrow it down to specific cities using our city picker or by typing a custom city list.

Do you support countries outside the US?+

Not yet — US coverage is our focus right now and it's fully built out. International coverage is actively on the roadmap. Vote for the country you need inside the dashboard to help us prioritize what comes next.

Can I scrape just a few specific cities instead of a whole state?+

Yes. You have three city modes: 'All cities' scrapes every city in your selected states automatically. 'Pick cities' opens a searchable checklist so you can hand-pick exactly which cities to include. 'Type cities' lets you paste a comma-separated list like 'Miami, Orlando, Tampa'.

What if I only want businesses in a specific zip code or neighborhood?+

Currently we scrape at the city level. Zip-code and neighborhood-level targeting is something we're looking at for a future update. For now, scraping a single city and then filtering the CSV by address is the best workaround.

Pricing & billing

How is your pricing so simple?+

We built MapsHarvest to do one job extremely well. One credit, one lead, flat rate. No per-feature add-ons, no compute units, no task math, no surprise overages. You always know exactly what you're paying before you start a scrape.

What happens if I run out of credits mid-scrape?+

The scrape stops when your credits hit zero. Any leads already collected are saved and available to download. You can top up credits and resume the scrape exactly where it stopped — our checkpoint resume feature means you never lose progress or re-scrape cities you've already done.

Do unused credits roll over?+

Top-up credits never expire. Monthly plan credits reset at your billing cycle. If you're on a paid plan and need to roll over credits, top-ups are the way to go — they stack on top of your plan allocation and don't expire.

Can I cancel anytime?+

Yes, directly from your account settings. No phone calls, no 30-day notice period, no retention emails. Cancel in 10 seconds. You keep access until the end of your current billing period.

Do you offer refunds?+

If you haven't used any credits and cancel within 48 hours of your first charge, reach out and we'll sort it out. Used credits are non-refundable — but you can always start on the free plan to verify data quality before paying.

Is there a discount for annual billing?+

We're working on annual plans. Drop us a message via the contact form and we can work something out for high-volume users in the meantime.

Features & tools

What are Smart Filters?+

Smart Filters let you skip businesses that don't meet your criteria before they're written to your export — so you only pay credits for leads that match. You can filter by minimum rating (e.g. 4+ stars), minimum or maximum review count, whether the business has a website, and whether it has a phone number listed.

What is Checkpoint Resume?+

If a scrape is cancelled, interrupted, or your credits run out mid-run, MapsHarvest saves your progress city by city. When you start the same scrape again, it picks up exactly where it left off — skipping cities already done. You never re-scrape or pay twice for the same data.

What are Scheduled Scrapes?+

Scheduled scrapes let you set a recurring scrape — daily, weekly, or monthly — and have fresh leads delivered automatically without lifting a finger. Set it up once and your pipeline refills on autopilot. Available on the Scale plan.

How do Webhooks work?+

When a scrape completes (or is stopped), MapsHarvest can automatically POST the results to any URL you specify. This works with Zapier, Make, n8n, Airtable automations, custom APIs, or any platform that accepts a webhook. You choose which fields to include in the payload and when the webhook fires (on completion, on stop, or manually). Available on the Growth plan and above.

What is the API?+

The MapsHarvest REST API lets you trigger scrapes, check job status, and download results programmatically from your own tools, scripts, or CRM. Available on Growth and Scale plans. Full documentation is at mapsharvest.com/docs.

What are Campaigns?+

Campaigns are folders for organizing your scrapes. Group related scrapes together (e.g. 'Roofing — Q3 2026'), export everything in the campaign at once, or send the full campaign dataset to a webhook. Available on Growth and Scale plans.

Can I choose which data fields to include in my export?+

Yes. The Data Fields picker lets you select a preset (Essential, Standard, Full) or build a completely custom field selection. Fewer fields means faster scrapes and a cleaner export. You can also customize exactly which fields are sent in webhook payloads.

Can I limit how many results I get per scrape?+

Yes. The Max Total Results setting lets you cap the entire scrape at a specific number of leads (100, 250, 500, 1,000, 2,500, or unlimited). The scrape stops automatically once that total is reached, regardless of how many cities are left. Useful when you want a focused list without running through an entire state.

Data storage & privacy

Do you store the leads I scrape?+

Your scrape results are stored temporarily so you can download them. Files are available for 30 days after the scrape completes, then permanently deleted. We don't use your scraped data for any purpose other than delivering it to you.

Who can see my scrape data?+

Only you. Scrape results are tied to your account and are not accessible to other users or shared with any third parties. We don't sell your data, period.

What happens to my data if I cancel?+

Your account data and scrape history are retained for 30 days after cancellation so you can export anything you need. After 30 days, everything is permanently deleted from our systems.

Is my payment information secure?+

All payment processing is handled by Stripe. We never see or store your full card details — Stripe handles everything end-to-end with bank-level encryption.

Still have questions?

We reply to every message within one business day.

Send us a message →