谷歌

SERP API 谷歌查詢參數

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

q ,搜索查詢(必填)

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

示例請求:

使用qpizza參數的示例

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 網域頁面 取得完整支援的網域列表。

示例請求:

查询qpizzaurl 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官方國家代碼表

示例請求:

查询 qpizza,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官方語言代碼表

示例請求:

查询qpizza,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] 聯繫我們。

Last updated

Was this helpful?