SERP API 谷歌查詢參數
使用 Thordata 的 SERP API 配置谷歌搜索查詢,包括本地化參數、地理位置、分頁以及「進階參數」輸出選項。
基礎參數
q (必填)
定義搜索關鍵詞,預設值為 q=pizza
。可輸入任意語言關鍵詞。
範例請求:
curl https://scraperapi.thordata.com/request \
-H "Content-Type: application/json" \
-H "Authorization: Bearer xxxxxxxxxxxxxxxx" \
-d "{\"url\": \"https://www.google.com/search?q=pizza^&json=1\"}"
本地化參數
domain (選填)
指定搜索域名,預設為 google.com
。支援完整域名列表:。
gl (選填)
指定國家/地區代碼(如 us
、jp
),影響搜索排序和本地化內容。預設為 us
。
範例請求:
-d "{\"url\": \"https://www.google.com/search?q=pizza^&gl=au^&json=1\"}"
hl (選填)
指定界面語言(如 en
、es
),預設為 en
。
範例請求:
-d "{\"url\": \"https://www.google.com/search?q=pizza^&hl=es^&json=1\"}"
cr (選填)
限制搜索結果來源國家(如 countryFR|countryDE
),需與 gl
搭配使用。
範例請求:
-d "{\"url\": \"https://www.google.com/search?q=pizza^&cr=countryFR|countryDE^&json=1\"}"
lr (選填)
限制搜索結果語言(如 lang_fr|lang_de
),優先於 hl
。
範例請求:
-d "{\"url\": \"https://www.google.com/search?q=pizza^&lr=lang_en|lang_fr^&json=1\"}"
地理位置參數
location + uule (選填)
模擬精確地理位置(如 location=India
+ uule=w+CAIQICIFSW5kaWE
)。
範例請求:
-d "{\"url\": \"https://www.google.com/search?q=pizza^&location=India^&uule=w+CAIQICIFSW5kaWE^&json=1\"}"
搜索類型
tbm (選填)
指定結果類型:
範例請求:
-d "{\"url\": \"https://www.google.com/search?q=pizza^&tbm=shop^&json=1\"}"
分頁參數
start (選填)
跳過指定數量結果(如 start=30
從第31條開始)。
範例請求:
-d "{\"url\": \"https://www.google.com/search?q=pizza^&start=30^&json=1\"}"
num (選填)
每頁返回結果數(預設 20
,最大 100
)。
範例請求:
-d "{\"url\": \"https://www.google.com/search?q=pizza^&num=50^&json=1\"}"
safe (選填)
過濾成人內容:
範例請求:
-d "{\"url\": \"https://www.google.com/search?q=pizza^&safe=active^&json=1\"}"
進階參數
ludocid (選填)
觸發特定知識圖譜數據(如企業詳情)。
範例請求:
-d "{\"url\": \"https://www.google.com/search?q=谷歌^&ludocid=14389889685039125943^&json=1\"}"
kgmid (選填)
直接調用知識圖譜條目(如 /m/0d6lp
對應舊金山)。
範例請求:
-d "{\"url\": \"https://www.google.com/search?q=谷歌^&kgmid=/m/0d6lp^&json=1\"}"
tbs (選填)
進階篩選:
時間範圍:qdr:h
(1小時內)、qdr:y
(1年內)
範例請求:
-d "{\"url\": \"https://www.google.com/search?q=pizza^&tbs=qdr:h^&json=1\"}"
nfpr (選填)
禁用拼寫修正(nfpr=1
)。
範例請求:
-d "{\"url\": \"https://www.google.com/search?q=googl^&nfpr=1^&json=1\"}"
filter (選填)
結果去重(1
啟用、0
禁用)。
範例請求:
-d "{\"url\": \"https://www.google.com/search?q=pizza^&filter=1^&json=1\"}"