Erste Schritte
MapLeads API
Die MapLeads API verwandelt eine Google-Maps-Suche in strukturierte Business-Leads — Namen, Telefonnummern, E-Mails, Websites und Social-Profile — die Sie programmatisch lesen oder exportieren können.
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.
Basis-URL
Base URL
https://api.mapleads.ai/v1Alle Endpunkte sind relativ zu dieser Basis.
Konventionen
- 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).