The Online scraper turns a list of Google Maps searches into one saved job. Each keyword runs in the cloud, keeps going after you close the tab, and produces its own CSV file when it finishes.
This guide walks through the dashboard exactly as it works today: where to enter keywords, what each job state means, how record allowances are counted, and how to view or download results.
Setup
Before you start
You need a G Maps Crawl account with the Online scraper selected as the active product. Sign in with Google or with a one-time code sent to your email — there is no password. If you also use the API, switch products from the menu at the top of the dashboard sidebar; the two products have separate plans and allowances.
Your plan sets two limits: how many keywords one scrape can contain, and how many records you can collect each month. One returned business counts as one record.
| Plan | Records / month | Keywords per scrape | CSV download |
|---|---|---|---|
| Free | 1,000 | 2 | Preview only |
| Lite | 20,000 | 5 | Included |
| Basic | 80,000 | 10 | Included |
| Growth | 250,000 | 20 | Included |
| Professional | 500,000 | 50 | Included |
| Enterprise | Custom | Custom | Included |
Optional
Try a free preview without signing in
The search box on the homepage runs a quick anonymous preview. It submits only the first non-empty line and shows up to 10 businesses with names, addresses, categories, ratings, review counts and phone numbers where available. Previews are limited per day and do not use your workspace credits.
When you want every result, more keywords, or a saved job you can come back to, sign in from the preview and continue in the dashboard.
Step by step
Create the scrape
Step 1: Open New scrape
After signing in, the Online dashboard opens on
/dashboard, titled New scrape. The description under the title confirms how many keywords your plan allows per scrape.Step 2: Paste one search per line
Each line is an independent Google Maps search. Include both the business type and the location, just as you would type it into Google Maps.
gmapscrawl.com/dashboardOnline scraper
New scrape
Find businesses on Google Maps. Your Basic plan includes up to 10 keywords per scrape.
Enter your keywords
One keyword per line. Add a business type and location to each search.
Coffee shops in Seattle Specialty coffee roasters in Portland, OR Bakeries in Capitol Hill, SeattleStart scrapingIllustration of the New scrape form on a Basic plan (10 keywords per scrape). Step 3: Select Start scraping
The dashboard creates one durable job containing an ordered search for each keyword and takes you to its detail page at
/dashboard/jobs/job_…. The submission uses an idempotency key, so a double click or a flaky connection will not create a duplicate job.If the button is disabled, check the message under the text box: you may have more keywords than your plan allows, a line longer than 200 characters, or no records left this month.
Better input, better data
Write keywords that return useful results
The dashboard normalizes your list before submitting it:
- Blank lines are ignored and repeated spaces are collapsed.
- Duplicates are removed case-insensitively —
Cafes in Austinandcafes in austinrun once. - Each keyword must be 200 characters or fewer.
- On the Free plan, only the first two distinct keywords are submitted.
| Instead of | Try | Why |
|---|---|---|
coffee | coffee shops in Seattle | A location keeps results relevant and comparable. |
restaurants in Texas | restaurants in Austin, TX | Google Maps returns a bounded list per search; narrower areas give more complete coverage. |
dentists near me | dentists in Brooklyn, NY | “Near me” depends on a browser location the cloud scraper does not have. |
plumbers Denver, electricians Denver | One trade per line | Each line is one search; mixing intents in one line blurs results. |
Monitoring
Follow the job
The job detail page refreshes automatically every five seconds until the job reaches a final state. You can leave the page at any time — the job keeps running, and you can find it again under Jobs, which lists every job with a state filter.
State
running
1 of 3 keyword shards succeeded
Expected units
360
Reserved maximum at durable admission
Accepted units
—
Settled server-observed units
Result records
118
Interface: dashboard
| State | What it means |
|---|---|
| queued | Accepted and waiting for scraper capacity. Your record reservation is already held. |
| submitting / running | Keyword searches are being sent to and processed by the cloud scraper. |
| reconciling / finalizing | Results are being imported, checked, and counted. |
| succeeded | Every keyword completed. All CSV files are available. |
| partial | Some keywords completed and some did not. Completed keywords still have CSV files. |
| failed | No usable result was produced. An error code is shown on the page. |
| cancel_requested | You canceled; in-flight work is being stopped and reconciled. |
| canceled | The job stopped. Units that had already crossed their charging boundary stay committed. |
Expected units is the maximum number of records reserved from your allowance when the job was accepted. Accepted units is what was actually settled once results were counted — usually lower. The difference is released back to your allowance. Track both on the Usage page.
Results
View and download each keyword’s CSV
When a job is succeeded or partial, a Keyword CSV files panel lists one file per keyword with its record count. Keywords that returned nothing still produce a file with column headers.
Keyword CSV files
One CSV per completed keyword. Searches with no results include the column headers.
Coffee shops in Seattle
120 records · CSV
ViewDownload CSVSpecialty coffee roasters in Portland, OR
64 records · CSV
ViewDownload CSVBakeries in Capitol Hill, Seattle
0 records · CSV
ViewDownload CSV
View opens a read-only table, 100 rows per page, so you can check relevance before downloading. Download CSV saves keyword-1.csv, keyword-2.csv, and so on, numbered in the order you entered the keywords.
Job controls
Cancel or retry a job
The Job controls panel at the bottom of the detail page changes with the job’s state:
Job controls
Cancellation is recorded before this page reports success.
Create a fresh retry job
I confirm this retry may reserve 360 Online record units.
| Action | Available when | Effect |
|---|---|---|
| Cancel job | The job is not yet final | Stops remaining work. Already-dispatched searches move to cancel_requested while they are reconciled. |
| Refresh status | Always | Reloads the latest state without waiting for the automatic refresh. |
| Confirm and retry | partial, failed, or canceled | Creates a new job with the same input. You must confirm the new record reservation first. |
Recap
Checklist
- Online scraper is the active product and your plan has records left.
- One business type plus one location per line, each under 200 characters.
- Large areas split into neighborhoods or towns.
- Job detail bookmarked, or found later under Jobs.
- Results checked with View before downloading each keyword’s CSV.
- Partial jobs noted as incomplete coverage before sharing the data.