Google Search
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" \
-d "q=pizza" \
-d "json=1"json ,輸出格式(非必填)
該參數定義了抓取結果的輸出格式。可選擇JSON、Light JSON和HTML(支持下載)格式，默認爲JSON。注意：當默認數據格式設置為輕量Light JSON輸出，僅包含來自Google的頂部自然搜索結果。
示例請求：
查询 q ：pizza ,json :1
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1"render_js ,JS渲染(非必填)
如果為 true，系統將使用瀏覽器執行頁面腳本並傳回完整渲染後的 HTML。
示例請求：
查询 q ：pizza ,render_js :true
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "render_js=true"no_cache ,禁用缓存(非必填)
關閉緩存：當no_cache開啟時，搜索引擎將被強制獲取更新的結果而不使用緩存數據，確保最新資訊。注意這可能導致查詢速度變慢。緩存蒐索免費，且不計入您的蒐索統計。
示例請求：
查询 q ：pizza ，no_cache :true
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "no_cache=true"ai_overview ,AI 概覽(非必填)
控制是否獲取Google搜索結果中的AI概覽（AI Overview）內容。計費方式：成功獲取AI概覽通常計為 1 次響應。 當首次請求僅返回page_token時，系統自動進行的第二次請求將額外計費，總共消耗 2 次響應。
示例請求：
查询 q ：pizza ，ai_overview :true
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "ai_overview=true"本土化
google_domain， 域名（非必填）
定義用於資料抓取的搜尋引擎網域（預設值：google.com）。 您可在系統中修改此參數，或參考 Google 網域頁面 取得完整支援的網域列表。
示例請求：
查询q ：pizza ，url ：google.co.ao的示例結果
gl ，國家（非必填）
指定搜尋結果的定位國家/地區（預設值：us）。採用兩位字母國家代碼（例如：us-美國，ru-俄羅斯，uk-英國）。
完整國家代碼支援清單請參閱：Google官方國家代碼表
示例請求：
查询 q ：pizza,gl：ru的示例結果
hl ，語言（非必填）
設定搜尋結果的介面語言（預設值：en）。採用標準語言代碼格式（例如：en-英文，es-西班牙文，zh-CN-簡體中文）。
完整語言代碼支援清單請參閱：Google官方語言代碼表
示例請求：
查询q ：pizza,hl： es的示例結果
cr，设置多个国家/地区(非必填)
限制結果至特定國家，使用 | 作為分隔符（例如：countryFR|countryDE）。
可與 gl 參數配使用以確保介面/內容語言一致。
gl 和 cr 參數可組合使用，但實際效果以cr 參數為優先。
示例請求：
查询q : pizza,cr: countryFR|countryDE的示例結果
lr，設置多語言（非必填）
使用 lang_XX 代碼（如 lang_fr|lang_de）依語言篩選結果。
若同時使用 hl 參數，此參數將覆蓋 hl 設定。
hl 與 lr 參數可同時使用，但實際效果以 lr 參數為優先。
示例請求：
查询 q : pizza,lr: lang_en|lang_fr的示例結果
地理位置
location，地理位置(非必填)
模擬從精確位置發起搜尋（需搭配 uule 參數使用）。若未指定，系統可能採用代理伺服器的地理位置。
示例請求：
查询 q : pizza,location:India,uule:w+CAIQICIFSW5kaWE的示例結果
uule ，編碼位置(非必填)
使用 Base64 編碼目標地理位置（需配合 location 參數使用）
示例請求：
查询 q : pizza,location:India,uule:w+CAIQICIFSW5kaWE的示例結果
搜索類型
tbm ，搜索類型（非必填）
定義搜索結果類型：
tbm=images– 圖片tbm=shops– 購物tbm=news– 新聞tbm=videos– 視頻
示例請求：
查询 q : pizza,tbm:shop的示例
分頁
start ，結果偏移量（非必填）
此參數定義結果偏移量。它會跳過指定數量的結果。它用於分頁。 （例如，0（預設值）表示第一頁結果，10 表示第二頁結果，20 表示第三頁結果，以此類推。）
建議從 0 開始，並以 10 遞增取得下一頁。起始偏移值沒有硬性上限，但我們建議最多 100，與 Google Maps 網頁版的行為一致。超過該值，結果可能會重複或不相關。
示例請求：
查询 q : pizza,start:30的示例
高級參數
ludocid ，Google 地點 ID（非必填）
此參數用於指定要擷取的「Google 我的商家」清單識別碼（CID，亦稱為 Google 地點 ID）。
示例請求：
查询 q : pizza,ludocid:14389889685039125943的示例
kgmid ，Google 知識圖譜谱 ID（非必填）
kgmid 此參數用於直接調用 Google 知識圖譜（Knowledge Graph）中特定條目的加密資料，將覆蓋常規搜尋參數並回傳結構化結果。
示例請求：
查询 q : pizza,kgmid:/m/0d6lp的示例
高級篩選
tbs ，高級搜索條件（非必填）
時間/類型篩選參數（支援進階條件設定），例如：
tbs=qdr:d：僅顯示24小時內的內容tbs=sur:f：限定搜尋結果僅呈現圖片
示例請求：
查询 q : pizza,tbs:sur:f的示例
safe ，成人內容過濾（非必填）
此參數用於設定是否過濾成人內容（預設值：依Google政策）。可指定值：
active：啟用嚴格過濾off：完全停用過濾 （注意：即使設為off，Google仍可能對露骨內容進行模糊化處理
示例請求：
查询 q : pizza,safe:active的示例
nfpr ，排除自動更正結果（非必填）
此參數用於設定是否停用搜尋關鍵字自動校正功能，例如：
nfpr=1：啟用嚴格模式（輸入「googl」將不會自動校正為「google」）nfpr=0：使用預設自動校正功能
示例請求：
查询 q : pizza,nfpr:1的示例
如需進一步幫助，請透過 [email protected] 聯繫我們。
Last updated