Google Shopping

SERP API 谷歌 Shopping 查詢參數

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

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_shopping" \
 -d "q=pizza" \
 -d "json=1"

本土化

google_domain，域名(非必填)

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

示例請求：

使用q：pizza,url ：google.co.ao參數的示例

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_shopping" \
 -d "q=pizza" \
 -d "google_domain=google.co.ao" \
 -d "json=1"

gl ，國家(非必填)

指定搜尋結果的定位國家/地區（預設值：us）。採用兩位字母國家代碼（如：us-美國，ru-俄羅斯，uk-英國）。

完整國家代碼支援清單請參閱：Google官方國家代碼表

示例請求：

使用q：pizza,gl：ru參數的示例

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_shopping" \
 -d "q=pizza" \
 -d "gl=ru" \
 -d "json=1"

hl ，語言(非必填)

設定搜尋結果的介面語言（預設值：en）。採用標準語言代碼格式（如：en-英文，es-西班牙文，zh-CN-簡體中文）。

完整語言代碼支援清單請參閱：Google官方語言代碼表

示例請求：

使用q：pizza,hl： es參數的示例

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_shopping" \
 -d "q=pizza" \
 -d "json=1" \
 -d "hl=es"

地理位置

location，地理位置(非必填)

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

示例請求：

使用q：pizza,location:India,uule:w+CAIQICIFSW5kaWE參數的示例

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_shopping" \
 -d "q=pizza" \
 -d "json=1" \
 -d "location=India" \
 -d "uule=w+CAIQICIFSW5kaWE"

uule ，UULE(非必填)

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

示例請求：

使用q：pizza,location:India,uule:w+CAIQICIFSW5kaWE參數的示例

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_shopping" \
 -d "q=pizza" \
 -d "json=1" \
 -d "location=India" \
 -d "uule=w+CAIQICIFSW5kaWE"

分頁

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

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

示例請求：

使用q：pizza,start:30參數的示例

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_shopping" \
 -d "q=pizza" \
 -d "json=1" \
 -d "start=30"

num ，每頁結果數（非必填）

設定搜尋結果每頁返回數量（預設值：10）。例如：num=10 表示每頁返回10筆結果。

示例請求：

使用q：pizza,num:20參數的示例

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_shopping" \
 -d "q=pizza" \
 -d "json=1" \
 -d "num=20"

高級參數

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

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

1. 時間範圍篩選：

   • qdr:h → 過去1小時（例：tbs=qdr:h）

   • qdr:d → 過去24小時（例：tbs=qdr:d）

   • qdr:w → 過去1週（例：tbs=qdr:w）

   • qdr:m → 過去1個月（例：tbs=qdr:m）

   • qdr:y → 過去1年（例：tbs=qdr:y）

2. 內容類型篩選：

   • sur:f → 僅顯示圖片結果（例：tbs=sur:f）

   • sur:fc → 僅顯示彩色圖片

   • sur:fm → 僅顯示動態圖片（GIF等）

3. 複合條件組合：

   • 可疊加多個條件（例：tbs=qdr:w,sur:f → 過去1週內的圖片結果）

示例請求：

使用q：pizza,tbs:sur:f參數的示例

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_shopping" \
 -d "q=pizza" \
 -d "json=1" \
 -d "tbs=sur:f"

shoprs ，過濾器ID（非必填）

此參數用於設定搜尋篩選器的輔助 ID，以精確控制搜尋結果的篩選條件。

示例請求：

使用q：pizza,shoprs:shoprs_1參數的示例

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_shopping" \
 -d "q=pizza" \
 -d "json=1" \
 -d "shoprs=shoprs_1"

min_price ，最低價格（非必填）

設定搜尋結果的最低價格門檻（單位：當地貨幣），此設定將覆寫任何透過 shoprs 參數嵌入的價格篩選條件。

示例請求：

使用q：pizza,min_price:10參數的示例

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_shopping" \
 -d "q=pizza" \
 -d "json=1" \
 -d "min_price=10"

max_price ，最高價格（非必填）

強制設定搜尋結果的最高價格上限（單位：當地貨幣），此設定將優先覆蓋所有透過 shoprs 或其他參數設定的價格篩選條件。

示例請求：

使用q：pizza,max_price:100參數的示例

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_shopping" \
 -d "q=pizza" \
 -d "json=1" \
 -d "min_price=10" \
 -d "max_price=100"

sort_by，排序依據（非必填）

功能說明：定義搜尋結果的排序規則，特別針對商品價格進行排序優化。

可用選項：

值	排序方式	適用場景
1	價格由低到高	比價採購、預算型消費
2	價格由高到低	奢侈品搜尋、高端商品市場分析

示例請求：

使用q：pizza,sort_by:1參數的示例

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_shopping" \
 -d "q=pizza" \
 -d "json=1" \
 -d "sort_by=1"

free_shipping，免費送貨（非必填）

制篩選出提供免運費服務的商品，排除所有需支付運費的搜尋結果

示例請求：

使用q：pizza,free_shipping:true參數的示例

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_shopping" \
 -d "q=pizza" \
 -d "gl=ad" \
 -d "json=1" \
 -d "free_shipping=true"

on_sale，特價中非必填）

强制筛选出标有促销标识的商品（如折扣价/限时优惠/满减活动），排除所有常规价格商品

示例請求：

使用q：pizza,on_sale:true參數的示例

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_shopping" \
 -d "q=pizza" \
 -d "gl=ad" \
 -d "json=1" \
 -d "on_sale=true"

small_business，小型企業（非必填）

進展示小型企業。

示例請求：

使用q：pizza,small_business:true參數的示例

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_shopping" \
 -d "q=pizza" \
 -d "gl=ad" \
 -d "json=1" \
 -d "small_business=true"

direct_link，包括直接連接（非必填）

控制搜尋結果是否包含商品的「直連購買連結」

示例請求：

使用q：pizza,direct_link:true參數的示例

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_shopping" \
 -d "q=pizza" \
 -d "gl=ad" \
 -d "json=1" \
 -d "direct_link=true"

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