為開發者打造的 G Maps Crawl

Google Maps 資料。
內建於您的工作流程。

搜尋商家、讀取公開評論、瀏覽地點照片和影片。透過同步 REST API 建立,或透過 MCP 讓您的 AI 助理直接連接。

結構化 JSON

結果在同一回應中傳回

REST + MCP

在您的應用程式或 AI 用戶端中使用

一套 API 額度

API 與 MCP 請求共用

選擇您的資料

為研究的每一步準備一個 API

先進行商家搜尋,然後使用該地點的 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 金鑰保存在伺服器端;為新任務使用新的冪等鍵,並在原請求不變的重試中保留同一冪等鍵。

回應

範例 JSON
{
  "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 以不變的請求主體重試。測試憑證傳回模擬資料,不消耗您的正式額度。

基於標準 HTTP 建立

一次小型整合,一條實用的資料工作流程。

01

建立 API 金鑰

在您的 API 工作區建立憑證,並將其保存在伺服器或用戶端的私密設定中。REST 和 MCP 共用同一 API 額度。

開啟 API 金鑰
02

選擇一個 API

按關鍵字和地點搜尋。取得評論和照片時,提供您已有的 Maps feature ID,或從搜尋結果中讀取 place.dataId。

按快速上手操作
03

讀取 JSON 回應

在您的應用程式中處理傳回的頁面。遵循端點的分頁規則,檢查缺失欄位,並為重試保留請求的冪等鍵。

瞭解分頁

建立有用的東西

將 Maps 資料帶進您的應用程式

將傳回的記錄作為您自己的研究、報告和內部工作流程的輸入。

01

本地商家研究

搜尋某個類別和地點,然後在您的應用程式中整理可用的商家名稱、地址、網站、電話號碼和評分。

02

評論分析

查詢某個地點的公開評論以研究客戶回饋。選擇一致的排序方式,並按可用頁數進行分析。

03

地點相簿研究

取得某個地點可用的照片和影片連結。將來源相簿連結與記錄一起保存,以便您的團隊檢視原始內容。

您的 AI 助理,已連線

在您的 AI 用戶端中使用同樣的資料。

連接 MCP 伺服器以取得可探索的工具,或安裝 Agent Skill 以取得可重複使用的工作流程說明和 REST 備用方案。

為您的已連線 AI 助理準備的範例任務

「搜尋西雅圖的一頁咖啡店。傳回可用的名稱、網站和評分,並指出缺失的資料。」

請求會消耗您的 API 額度。使用測試憑證時,結果為模擬資料。

規劃您的整合

在擴大規模前瞭解用量

每個成功的正式頁面(包括空白頁面)消耗一次 API 請求。REST 與 MCP 共用您的 API 方案;線上擷取工具和瀏覽器擴充功能有獨立的額度。

讓請求可預測

先從一頁開始,檢查傳回的欄位,並為端點設定合適的用戶端逾時。重試時,使用相同的 Idempotency-Key 和不變的請求主體。

方案限額、速率限制、來源可用性和資訊補全都會影響正式請求。測試憑證傳回模擬資料,不消耗您的正式額度。

請查看各端點頁面瞭解請求限制和結果欄位。價格頁面列出了目前包含的請求數和付費超額費率。

常見問題

有哪些可用的 Google Maps API?

G Maps Crawl 提供商家搜尋、公開地點評論和地點照片/相簿 API。Search 傳回商家記錄;Reviews 和 Photos 使用 Maps feature ID 傳回特定地點的一頁資料。

我可以使用 Python 或 JavaScript 嗎?

可以。這些 API 使用 HTTP 請求和 JSON,因此您可以用 Python、JavaScript、cURL 或其他 HTTP 用戶端呼叫。每個 API 頁面都包含請求範例和回應範例。

我需要輪詢任務結果嗎?

公開的 Search、Reviews 和 Photos API 在同一回應中傳回 JSON,不需要任務輪詢或 webhook 設定。請遵循端點的逾時和重試指引。

API、MCP 和 Agent Skill 如何搭配運作?

REST 讓您的應用程式直接呼叫端點。MCP 讓相容的 AI 用戶端可以使用這些工具。Agent Skill 提供工作流程說明和輔助指令碼。REST 和 MCP 請求都需要 API 憑證並消耗您的 API 額度。

我在哪裡取得用於評論和照片的 feature ID?

使用您已有的 Maps feature ID,或從 Search API 的 data.businesses 陣列中複製符合記錄的 place.dataId,並將該值作為 fid 傳給 Reviews 或 Photos API。

是否保證每個欄位都可用?

不是。傳回的欄位取決於來源和所選操作。在使用資料前,請檢查缺失值和可用的觀測時間戳記。成功的回應也可能包含空白頁面。

踏出下一步

建立您的第一個 Google Maps 資料工作流程。

建立 API 金鑰,從一個請求開始,探索您的應用程式可以使用的資料。