Quick start · 5 minutes
Three commands, one CSV.
1
Get an API key
Sign up at app.gmapsdataextractor.com — 250 free credits, no credit card. Copy your key from the dashboard.
# Save it as an env var export GMAPS_API_KEY="sk_live_..."
2
Create a job
curl -X POST https://api.gmapsdataextractor.com/v1/jobs \
-H "X-API-Key: $GMAPS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"queries":["plumbers in Miami, FL"], "max_results": 250}'
# → { "job_id": "job_01HV4N2K", "status": "queued" }3
Export
curl "https://api.gmapsdataextractor.com/v1/jobs/job_01HV4N2K/export?fmt=csv" \ -H "X-API-Key: $GMAPS_API_KEY" -o plumbers.csv
Authentication
Every request takes an X-API-Key header. Keys are workspace-scoped. Rotate via the dashboard. Compromised keys: revoke immediately — no jobs can be created from a revoked key, but in-flight jobs continue.
Your first job
A job is a unit of work: one or more queries, an optional list of enrichment passes, and a result cap. Jobs are async by default; use /v1/lookup for synchronous Place ID lookups under 1 second.
API reference
POST/v1/jobs
Create a new extraction job
idempotentGET/v1/jobs/{id}
Fetch job status + counts
cachedGET/v1/jobs/{id}/results
Stream results as NDJSON
streamGET/v1/jobs/{id}/export
Download CSV / Excel / JSON
asyncDELETE/v1/jobs/{id}
Cancel a queued or running job
POST/v1/lookup
Sync single-Place lookup, <1s
syncGET/v1/users/plans
List all plans + pricing
publicPOST/v1/webhooks
Register a webhook (Scale+)
scale+Guides
guide · 6 min
Bulk extraction at scale
Run 75 queries in one job and stream results.
guide · 4 min
Handling rate limits
Headers, backoff, and burst windows.
guide · 3 min
Sync lookup endpoint
Sub-second single-Place enrichment.
guide · 5 min
Webhook integration
Job lifecycle events for Scale+.
guide · 4 min
CSV export best practices
Schema config, encoding, large jobs.
guide · 6 min
Enrichment cost optimization
When to enrich, when to skip.