谷歌

SERP API 谷歌查詢參數

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

q ，搜索查詢(必填)

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

示例請求：

使用q：pizza參數的示例

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1\"}"

本土化

url， 域名（非必填）

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

示例請求：

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

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.co.ao/search?q=pizza^&json=1\"}"
gl ，國家（非必填）

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

示例請求：

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

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&gl=ru^&json=1\"}"
hl ，語言（非必填）

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

示例請求：

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

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&hl=es\"}"
cr，设置多个国家/地区(非必填)

限制結果至特定國家，使用 | 作為分隔符（例如：countryFR|countryDE）。

可與 gl 參數配使用以確保介面/內容語言一致。

gl 和 cr 參數可組合使用，但實際效果以cr 參數為優先。

示例請求：

查询q : pizza,cr: countryFR|countryDE的示例結果

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&cr=countryFR|countryDE\"}"
lr，設置多語言（非必填）

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

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

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

示例請求：

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

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{"url": "https://www.google.com/search?q=pizza^&json=1^&lr=lang_en|lang_fr"}"

地理位置

location，地理位置(非必填)

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

示例請求：

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

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&location=India^&uule=w+CAIQICIFSW5kaWE\"}"
uule ，UULE(非必填)

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

示例請求：

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

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&location=India^&uule=w+CAIQICIFSW5kaWE\"}"

搜索類型

tbm ，搜索類型（非必填）

定義搜索結果類型：

  • tbm=isch – 圖片

  • tbm=shop – 購物

  • tbm=nws – 新聞

  • tbm=vid – 視頻

示例請求：

查询 q : pizza,tbm:shop的示例

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&tbm=shop\"}"

分頁

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

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

示例請求：

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

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&start=30\"}"
num ，煤業結果數（非必填）

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

示例請求：

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

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&num=20\"}"

高級參數

ludocid ，Google 地點 ID（非必填）

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

示例請求：

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

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=Google^&json=1^&ludocid=14389889685039125943\"}"
kgmid ，Google 知識圖譜谱 ID（非必填）

kgmid 此參數用於直接調用 Google 知識圖譜（Knowledge Graph）中特定條目的加密資料，將覆蓋常規搜尋參數並回傳結構化結果。

示例請求：

查询 q : pizza,kgmid:/m/0d6lp的示例

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=Google^&json=1^&kgmid=/m/0d6lp\"}"
ibp ，Google 元素渲染（非必填）

此參數用於控制特定元素（如含 ludocid 的知識圖譜擴展搜尋）的版面渲染與展開效果。

示例請求：

查询 q : pizza,ibp:new的示例

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&ibp=new\"}"

高級篩選

tbs ，高級搜索條件（非必填）

時間/類型篩選參數（支援進階條件設定），例如：

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

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

示例請求：

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

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&tbs=sur:f\"}"
safe ，安全（非必填）

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

  • active：啟用嚴格過濾

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

示例請求：

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

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&safe=active\"}"
nfpr ，排除自動更正結果（非必填）

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

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

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

示例請求：

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

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&nfpr=1\"}"
filter ，結果篩選（非必填）

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

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

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

示例请求：

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

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1^&filter=1\"}"

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

Previous查詢參數NextBing

Last updated

Was this helpful?