创建 API 密钥
在您的 API 工作区创建凭据,并将其保存在服务器或客户端的私密配置中。REST 和 MCP 共享同一 API 额度。
打开 API 密钥结构化 JSON
结果在同一响应中返回
REST + MCP
在您的应用或 AI 客户端中使用
一套 API 额度
API 与 MCP 请求共享
选择您的数据
先进行商户搜索,然后使用该地点的 feature ID 请求评价或相册内容。每个 API 都有独立的示例和字段参考。
您的第一个 API 请求
在 Authorization 头中使用 API 密钥。浏览下面的请求格式,然后按照快速上手指南发起第一次调用。
完整的接口约定请参见 API 文档。
curl https://gmapscrawl.com/api/v1/search \
-H "Authorization: Bearer $GMSCRAPER_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: seattle-coffee-search-001" \
-d '{"q":"coffee shops in Seattle","page":1,"extra":false}'示例为空响应。正式搜索会返回可用的商户。请将 API 密钥保存在服务器端;为新任务使用新的幂等键,并在原请求不变的重试中保留同一幂等键。
{
"data": {
"total": 0,
"params": {
"q": "coffee shops in Seattle",
"page": 1,
"hl": "en",
"extra": false
},
"businesses": []
},
"request_id": "req_example",
"schema_version": "2026-09-22"
}API 在同一响应中返回 JSON。超时后,请使用相同的 Idempotency-Key 以不变的请求体重试。测试凭据返回模拟数据,不消耗您的正式额度。
构建有用的东西
将返回的记录用作您自己的研究、报告和内部工作流的输入。
搜索某个类别和地点,然后在您的应用中整理可用的商户名称、地址、网站、电话号码和评分。
查询某个地点的公开评价以研究客户反馈。选择一致的排序方式,并按可用页数开展分析。
获取某个地点可用的照片和视频链接。将来源相册链接与记录一起保存,以便您的团队查看原始上下文。
您的智能体,已连接
连接 MCP 服务器以获得可发现的工具,或安装 Agent Skill 以获得可复用的工作流说明和 REST 备用方案。
为您的已连接智能体准备的示例任务
“搜索西雅图的一页咖啡店。返回可用的名称、网站和评分,并指出缺失的数据。”
请求消耗您的 API 额度。使用测试凭据时,结果为模拟数据。
规划您的集成
每个成功的正式页面(包括空页面)消耗一次 API 请求。REST 与 MCP 共享您的 API 套餐;在线抓取工具和浏览器扩展有独立的额度。
先从一页开始,检查返回的字段,并为端点设置合适的客户端超时。重试时,使用相同的 Idempotency-Key 和不变的请求体。
套餐限额、速率限制、来源可用性和信息补全都会影响正式请求。测试凭据返回模拟数据,不消耗您的正式额度。
请查看各端点页面了解请求限制和结果字段。价格页面列出了当前包含的请求数和付费超额费率。
G Maps Crawl 提供商户搜索、公开地点评价和地点照片/相册 API。Search 返回商户记录;Reviews 和 Photos 使用 Maps feature ID 返回特定地点的一页数据。
可以。这些 API 使用 HTTP 请求和 JSON,因此您可以用 Python、JavaScript、cURL 或其他 HTTP 客户端调用。每个 API 页面都包含请求示例和响应示例。
公开的 Search、Reviews 和 Photos API 在同一响应中返回 JSON,不需要任务轮询或 webhook 配置。请遵循端点的超时和重试指引。
REST 让您的应用直接调用端点。MCP 让兼容的 AI 客户端可以使用这些工具。Agent Skill 提供工作流说明和辅助脚本。REST 和 MCP 请求都需要 API 凭据并消耗您的 API 额度。
使用您已有的 Maps feature ID,或从 Search API 的 data.businesses 数组中复制匹配记录的 place.dataId,并将该值作为 fid 传给 Reviews 或 Photos API。
不是。返回的字段取决于来源和所选操作。在使用数据前,请检查缺失值和可用的观测时间戳。成功的响应也可能包含空页面。