API Docs — Google Maps Scraper

Build maps lead extraction into your product with asynchronous jobs and predictable JSON contracts.

MapLeads exposes a public, versioned developer API under /v1. The workflow is consistent: submit a scrape job, poll until it reaches a terminal state, then read or export the leads.

Base URL

https://api.mapleads.ai

All endpoint paths include the versioned /v1 prefix and are relative to that API origin.

Conventions

Authentication. API clients authenticate with a MapLeads API key. See Authentication.
JSON. Request and response bodies use JSON. Errors use { "error": "code" } with a matching HTTP status.
Collections. List endpoints return { "data": [...] }; lead listings also include total.
Asynchronous jobs. Scraping runs as a job. Create it, poll its status, then read leads when its status is completed.
Credit metering. Each extracted lead consumes one credit. See Usage and credits.
Rate limits. Limits are evaluated per API key and the effective value is returned by GET /v1/usage.

Start building

Authentication

Create a key and send it safely.

API Reference

Inspect request and response schemas generated from OpenAPI.

Quickstart

Create your first scrape job over HTTP.