建立 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 以不變的請求主體重試。測試憑證傳回模擬資料,不消耗您的正式額度。
建立有用的東西
將傳回的記錄作為您自己的研究、報告和內部工作流程的輸入。
搜尋某個類別和地點,然後在您的應用程式中整理可用的商家名稱、地址、網站、電話號碼和評分。
查詢某個地點的公開評論以研究客戶回饋。選擇一致的排序方式,並按可用頁數進行分析。
取得某個地點可用的照片和影片連結。將來源相簿連結與記錄一起保存,以便您的團隊檢視原始內容。
您的 AI 助理,已連線
連接 MCP 伺服器以取得可探索的工具,或安裝 Agent Skill 以取得可重複使用的工作流程說明和 REST 備用方案。
為您的已連線 AI 助理準備的範例任務
「搜尋西雅圖的一頁咖啡店。傳回可用的名稱、網站和評分,並指出缺失的資料。」
請求會消耗您的 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。
不是。傳回的欄位取決於來源和所選操作。在使用資料前,請檢查缺失值和可用的觀測時間戳記。成功的回應也可能包含空白頁面。