What one credit means
| Job type | One credit | Important detail |
|---|---|---|
| Leads | One Google Maps place row returned | Email and social enrichment add no separate charge |
| Reviews | One review row collected | The selected place itself is not an extra review credit |
| Photos | One unique photo URL | Duplicate URLs are removed before charging |
Monthly credits, free credits, and permanent packs
- Free starter credits are a lifetime allowance; they do not renew each month.
- Subscription credits refresh each billing cycle and unused monthly credits do not roll over.
- Permanent credit packs do not expire and remain available alongside an eligible account.
- Pack-only accounts receive Starter-level Online features; Agent API and MCP still require Growth or higher.
Current plan allotments and pack sizes are listed on Pricing. Buying a pack changes the available permanent balance, not the monthly renewal rules.
One running Maps job per account
Leads, reviews, and photos share one in-flight lock across the Online UI, MCP, and HTTP API. Finish, fail, or cancel the active job before starting another. A competing request returns HTTP 409.
- Create one job.
- Poll until it is completed, partial, or failed.
- Fetch every results page.
- Start the next keyword or place only after the previous job has reached a terminal state.
Web batches vs Agent and API requests
| Surface | Input rule | Best for |
|---|---|---|
| Online web UI | A plan-dependent list of keywords or places, queued sequentially | Visual review and CSV downloads |
| MCP / HTTP leads | Exactly one keyword per create-job request | Agent chats, scripts, and integrations |
| MCP / HTTP reviews or photos | Exactly one place per create-job request | Sequential place automation |
For API authentication, polling, pagination, and status codes, use the Agent handbook and HTTP API reference.
Online and Chrome extension quotas are separate
Online web jobs, MCP, and HTTP use the Online account and its shared credit pool. Chrome products have their own plans and quotas; extension usage does not draw from the Online pool.
- Google Maps Extractor is the bulk on-map Chrome workflow and uses the official ZIP installation.
- Google Maps Leads Finder is the single-place Chrome Web Store workflow.
- Online Google Maps Extractor is the cloud workflow for keyword batches, history, CSV zips, and Agent access.
Credit and access errors
| Status | Meaning | Next step |
|---|---|---|
| 401 | Missing or invalid API key | Check the Bearer key in Account |
| 402 | No usable credits remain | Wait for renewal, buy a pack, or upgrade |
| 403 | Plan does not include Agent API | Use Online or choose Growth+ |
| 409 | Another Maps job is running | Wait for the current job to finish |