Google Local

SERP API 谷歌查詢參數

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

q ,搜索查詢(必填)

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

示例請求:

使用qpizza參數的示例

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

本土化

google_domain, 域名(非必填)

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

示例請求:

查询qpizzaurl 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_local" \
 -d "q=pizza" \
 -d "google_domain=google.co.ao" \
 -d "json=1"
gl ,國家(非必填)

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

示例請求:

查询 qpizza,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_local" \
 -d "q=pizza" \
 -d "gl=ru" \
 -d "json=1"
hl ,語言(非必填)

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

示例請求:

查询qpizza,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_local" \
 -d "q=pizza" \
 -d "json=1" \
 -d "hl=es"

地理位置

location,地理位置(非必填)

模擬從精確位置發起搜尋(需搭配 uule 參數使用)。若未指定,系統可能採用代理伺服器的地理位置。

示例請求:

查询 q : pizza,location:India,uule:w+CAIQICIFSW5kaWE的示例結果

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_local" \
 -d "q=pizza" \
 -d "json=1" \
 -d "location=India" \
 -d "uule=w+CAIQICIFSW5kaWE"
uule ,UULE(非必填)

使用 Base64 編碼目標地理位置(需配合 location 參數使用)

示例請求:

查询 q : pizza,location:India,uule:w+CAIQICIFSW5kaWE的示例結果

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

分頁

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_local" \
 -d "q=pizza" \
 -d "json=1" \
 -d "start=30"

高級參數

ludocid ,Google 地點 ID(非必填)

此參數用於指定要擷取的「Google 我的商家」清單識別碼(CID,亦稱為 Google 地點 ID)。

示例請求:

查询 q : pizza,ludocid:14389889685039125943的示例

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

高級篩選

tbs ,高級搜索條件(非必填)

時間/類型篩選參數(支援進階條件設定),例如:

  • tbs=qdr:d:僅顯示24小時內的內容

  • tbs=sur:f:限定搜尋結果僅呈現圖片

示例請求:

查询 q : pizza,tbs:sur:f的示例

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

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

Last updated

Was this helpful?