Google Shopping SERP API 參數指南

查看 Google Shopping SERP API 參數，設定商品查詢、地區、語言與篩選條件，取得購物搜尋數據。

透過 Talordata SERP API，您可以配置 Google 購物搜索查詢，包括本地化、地理位置以及進階參數等輸出選項。

q ，搜索查詢（必填）

定義用於數據抓取的搜索查詢（預設值：q=pizza）。支援任何語言的任意關鍵詞。

示例請求：

使用q：pizza參數的示例

curl -X POST https://serpapi.talordata.net/serp/v1/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://serpapi.talordata.net/serp/v1/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://serpapi.talordata.net/serp/v1/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://serpapi.talordata.net/serp/v1/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://serpapi.talordata.net/serp/v1/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 ，編碼位置(非必填)

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

示例請求：

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

curl -X POST https://serpapi.talordata.net/serp/v1/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 ，結果偏移量（非必填）

此參數定義結果偏移量。它會跳過指定數量的結果。它用於分頁。（例如，0（預設值）表示第一頁結果，10 表示第二頁結果，20 表示第三頁結果，以此類推。）

示例請求：

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

curl -X POST https://serpapi.talordata.net/serp/v1/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://serpapi.talordata.net/serp/v1/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 ，高級搜索條件（非必填）

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

時間範圍篩選：
- 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）
內容類型篩選：
- sur:f → 僅顯示圖片結果（例：tbs=sur:f）
- sur:fc → 僅顯示彩色圖片
- sur:fm → 僅顯示動態圖片（GIF等）
複合條件組合：
- 可疊加多個條件（例：tbs=qdr:w,sur:f → 過去1週內的圖片結果）

示例請求：

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

curl -X POST https://serpapi.talordata.net/serp/v1/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://serpapi.talordata.net/serp/v1/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://serpapi.talordata.net/serp/v1/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://serpapi.talordata.net/serp/v1/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://serpapi.talordata.net/serp/v1/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://serpapi.talordata.net/serp/v1/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://serpapi.talordata.net/serp/v1/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://serpapi.talordata.net/serp/v1/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://serpapi.talordata.net/serp/v1/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]聯繫我們。

上一页Google Search 下一页Google Local

最后更新于 8天前