For the complete documentation index, see llms.txt. This page is also available as Markdown.

Google Trends SERP API 參數指南

查看 Google Trends 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_trends" \
 -d "q=pizza" \
 -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_trends" \
 -d "q=pizza" \
 -d "json=1" \
 -d "hl=es"
geo ,位置(非必填)

此參數用於設定您希望搜尋的地理位置。預設值為全球範圍(當未設定或 geo 參數值為空時啟用)。完整支援的 Google Trends 地理位置清單請參閱:Google Trends 地理位置。

範例請求:

使用參數 q : pizza, geo : India 的範例結果

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_trends" \
 -d "q=pizza" \
 -d "json=1" \
 -d "geo=India"
region,地區(非必填)

此參數用於在使用「按地區比較區段」和「按地區興趣分佈」資料類型圖表時獲得更精確的結果。其他資料類型圖表不接受此區域參數。預設值取決於設定的地理區域。可用選項包括:

  • COUNTRY - 國家

  • REGION - 次區域

  • DMA - 都會區

  • CITY - 城市

範例請求:

使用參數 q : pizza, region : COUNTRY 的範例結果

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

搜尋類型

data_type ,資料型別(非必填)

參數用於設定您要執行的搜尋類型。可用選項包括:

  • TIMESERIES - 時間趨勢分析:可接受單一或多個查詢

  • GEO_MAP - 區域比較分析:僅接受多個查詢

  • GEO_MAP_0 - 區域興趣分佈:僅接受單一查詢

  • RELATED_TOPICS - 相關主題:僅接受單一查詢

  • RELATED_QUERIES - 相關查詢:僅接受單一查詢

範例請求:

使用參數 q : pizza, data_type : TIMESERIES 的範例結果

高級參數

tz,時區(非必填)

此參數用於設定時區偏移量。預設值為 420(太平洋夏令時間 (PDT):-07:00)。數值以分鐘為單位,範圍從 -1439 至 1439

計算 tz 值的方法: 取 UTC+0 與目標時區的時間差(以分鐘為單位)。例如:

  • 太平洋夏令時間 (PDT, UTC-7) → tz = -7 * 60 = -420

  • 臺灣標準時間 (TST, UTC+8) → tz = 8 * 60 = 480

範例請求:

使用參數 q : pizza, tz : -420 的範例結果(PDT 時區)

cat,類別 (非必填)

此參數用於設定搜尋類別。預設值為 0(所有類別)。

範例請求:

使用參數 q : pizza, cat: 7 的範例結果

gprop ,財產(非必填)

此參數用於按屬性類別排序搜尋結果。預設屬性為「網頁搜尋」(當未設定或 gprop 參數值為空時啟用)。其他可用選項包括:

  • images - 圖片搜尋

  • news - 新聞搜尋

  • froogle - Google 購物

  • youtube - YouTube 搜尋

範例請求:

使用參數 q : pizza, gprop : froogle 的搜尋結果

date ,日期(非必填)

此參數用於設定搜尋日期範圍。可用選項包括:

預設時間範圍

  • now 1-H - 過去1小時

  • now 4-H - 過去4小時

  • now 1-d - 過去1天

  • now 7-d - 過去7天

  • today 1-m - 過去30天

  • today 3-m - 過去90天

  • today 12-m - 過去12個月

  • today 5-y - 過去5年

  • all - 2004年至今

自訂日期格式(2004年至今): yyyy-mm-dd yyyy-mm-dd(例如:2021-10-15 2022-05-25

範例請求:

使用參數 q : pizza, date : now 1-H 的搜尋結果

如果您需要更多幫助,請隨時通過在線客服或 [email protected]聯繫我們。

最后更新于