入门
MapLeads API
MapLeads API 把一次 Google Maps 搜索变成结构化商户线索——名称、电话、邮箱、网站与社交主页——可程序化读取或导出。
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).