入門
MapLeads API
MapLeads API 把一次 Google Maps 搜尋變成結構化商家名單——名稱、電話、Email、網站與社群主頁——可程式化讀取或匯出。
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
Base URL
https://api.mapleads.ai/v1所有端點均相對此 base。
約定
- 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).