Google Videos

SERP API 谷歌查詢參數

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

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

本土化

url， 域名（非必填）

定義用於資料抓取的搜尋引擎網域（預設值：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_videos" \
 -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_videos" \
 -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_videos" \
 -d "q=pizza" \
 -d "json=1" \
 -d "hl=es"

lr，設置多語言（非必填）

使用 lang_XX 代碼（如 lang_fr|lang_de）依語言篩選結果。

若同時使用 hl 參數，此參數將覆蓋 hl 設定。

hl 與 lr 參數可同時使用，但實際效果以 lr 參數為優先。

示例請求：

查询 q : pizza,lr: lang_en|lang_fr的示例結果

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

地理位置

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_videos" \
 -d "q=pizza" \
 -d "json=1" \
 -d "location=India" \
 -d "uule=w+CAIQICIFSW5kaWE"

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_videos" \
 -d "q=pizza" \
 -d "json=1" \
 -d "location=India" \
 -d "uule=w+CAIQICIFSW5kaWE"

分頁

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

此參數定義結果偏移量。它會跳過指定數量的結果。它用於分頁。 （例如，0（預設值）表示第一頁結果，10 表示第二頁結果，20 表示第三頁結果，以此類推。）

示例請求：

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

num ，煤業結果數（非必填）

設定搜尋結果每頁回傳的最大數量（例如：num=10 表示每頁回傳10筆結果）。

示例請求：

查询 cq : pizza,num:20的示例

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

高級篩選

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_videos" \
 -d "q=pizza" \
 -d "json=1" \
 -d "tbs=sur:f"

safe ，成人內容過濾（非必填）

此參數用於設定是否過濾成人內容（預設值：依Google政策）。可指定值：

• active：啟用嚴格過濾

• off：完全停用過濾 （注意：即使設為off，Google仍可能對露骨內容進行模糊化處理

示例請求：

查询 q : pizza,safe:active的示例

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

nfpr ，排除自動更正結果（非必填）

此參數用於設定是否停用搜尋關鍵字自動校正功能，例如：

• nfpr=1：啟用嚴格模式（輸入「googl」將不會自動校正為「google」）

• nfpr=0：使用預設自動校正功能

示例請求：

查询 q : pizza,nfpr:1的示例

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

filter ，結果篩選（非必填）

此參數用於控制搜尋結果去重功能：

• 1：啟用結果去重（移除重複內容）

• 0：停用結果去重（顯示完整結果）

示例请求：

查询 q : pizza,filter:1的示例

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

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