Premiers pas
API MapLeads
L'API MapLeads transforme une recherche Google Maps en leads B2B structurés — noms, téléphones, emails, sites web et profils sociaux — que vous pouvez lire ou exporter par programme.
This is the public, versioned developer API, served under /v1. The workflow is always the same: submit a scrape job, poll until it finishes, then read or export the leads.
URL de base
Base URL
https://api.mapleads.ai/v1Tous les endpoints sont relatifs à cette base.
Conventions
- Authentication. API clients authenticate with an API key. See Authentication. MapLeads Web uses the same
/v1scrape endpoints; its browser session only replaces the API key for authentication. - JSON. Request and response bodies are JSON. Errors come back as
{ "error": "code" }with a matching HTTP status. - Collections. List endpoints return
{ "data": [ ... ] }; lead listings also include atotal. - Asynchronous jobs. Scraping runs as a job — create it, poll its status, then read the leads when it is
completed. - Credit metering. Each extracted lead costs one credit. See Usage & credits.
- Rate limits. Requests are limited per API key (120/minute by default).