API do MapLeads

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 base

https://api.mapleads.ai/v1

Todos os endpoints são relativos a esta base.

Convenções

• Authentication. API clients authenticate with an API key. See Authentication. MapLeads Web uses the same /v1 scrape 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 a total.
• 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).