谷歌
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] 聯繫我們。
Last updated
Was this helpful?