MapLeads API

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.

Base URL

https://api.mapleads.ai/v1

All endpoints are relative to this base.

Conventions

• Authentication. Every request is authenticated with an API key. See Authentication. (The dashboard's own /api/* endpoints are internal and not part of this contract.)
• 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).