Google Maps

SERP API Google 查詢參數

使用 Thordata 的 SERP API 配置 Google 搜索查詢，包括本地化參數、地理定位、搜索類型、分頁以及「高級參數」輸出選項。

q ，搜索查詢(必填)

定義用於數據抓取的搜索查詢（默認值：q=pizza）。支持任何語言的任意關鍵詞。

示例請求：

使用q：pizza參數的示例

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_maps" \
 -d "q=pizza" \
 -d "json=1"

本土化

google_domain， 域名（非必填）

定義用於資料抓取的搜尋引擎網域（預設值：google.com）。 您可在系統中修改此參數，或參考 Google 網域頁面 取得完整支援的網域列表。

示例請求：

查询q ：pizza ，url ：google.co.ao的示例結果

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_maps" \
 -d "q=pizza" \
 -d "google_domain=google.co.ao" \
 -d "json=1"

gl ，國家（非必填）

指定搜尋結果的定位國家/地區（預設值：us）。採用兩位字母國家代碼（例如：us-美國，ru-俄羅斯，uk-英國）。 完整國家代碼支援清單請參閱：Google官方國家代碼表

示例請求：

查询 q ：pizza,gl：ru的示例結果

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_maps" \
 -d "q=pizza" \
 -d "gl=ru" \
 -d "json=1"

hl ，語言（非必填）

設定搜尋結果的介面語言（預設值：en）。採用標準語言代碼格式（例如：en-英文，es-西班牙文，zh-CN-簡體中文）。 完整語言代碼支援清單請參閱：Google官方語言代碼表

示例請求：

查询q ：pizza,hl： es的示例結果

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_maps" \
 -d "q=pizza" \
 -d "json=1" \
 -d "hl=es"

分頁

start ，結果偏移量（非必填）

設定搜尋結果分頁起始點（例如 "start=30" 表示跳過前 30 筆結果，從第 31 筆開始顯示）。

示例請求：

查询 q : pizza,start:30的示例

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_maps" \
 -d "q=pizza" \
 -d "json=1" \
 -d "start=30"

地理位置

ll ,GPS 座標（非必填）

GPS 參數用於定義搜索來源位置的座標，其值必須符合以下格式： @ + 緯度 + , + 經度 + , + 縮放級別 例如： @40.7455096,-74.0083012,14z

請求範例： 查詢參數 q（關鍵字）：pizza，並搭配 ll（定位參數）： @40.7455096,-74.0083012,14z

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_maps" \
 -d "q=pizza" \
 -d "json=1" \
 -d "[email protected],-74.0083012,14z"

搜尋類型

type ,搜尋類型（非必填）

搜尋參數定義了要執行的搜尋類型，它可以設定為： search - 當 q 參數設定時，返回結果列表， place - 當 data 參數設定時，返回特定地點的結果 使用 place_id 或 data_cid 時不需要參數。

範例請求：

q : pizza,type:search 的範例結果

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_maps" \
 -d "q=pizza" \
 -d "json=1" \
 -d "type=search"

高級參數

data ,數據（非必填）

參數可用於篩選搜尋結果。您可以訪問 Google 地圖網站，設定所需的篩選條件，然後直接從其 URL 中複製數據值到 SerpApi 的 URL。

範例請求：

q : pizza,data:20250815 的範例結果

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_maps" \
 -d "q=pizza" \
 -d "json=1" \
 -d "data=20250815"

place_id ,地點 ID（非必填）

參數定義了 Google 地圖中地點的唯一參照。Place ID 適用於大多數地點，包括商家、地標、公園和交叉路口。您可以使用我們的 Google Maps API 來查詢 place_id。

範例請求：

q : pizza,place_id:541541233999 的範例結果

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_maps" \
 -d "q=pizza" \
 -d "json=1" \
 -d "data=20250815" \
 -d "place_id=541541233999"

data_cid ,Google CID（非必填）

參數定義了 Google 地圖中地點的 CID（客戶識別碼）。此參數可在 Google Maps API 本地結果、Google Search API 和 Google Local API 本地結果中找到，名稱為 place_id。您也可以使用 Google 的 CID 轉換工具來取得它。

範例請求：

q : pizza,data_cid:001 的範例結果

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_maps" \
 -d "q=pizza" \
 -d "json=1" \
 -d "data_cid=001"

如需進一步幫助，請透過 [email protected] 聯繫我們。