# Google Trends

**SERP API Google 查詢參數**

使用 Thordata 的 SERP API 配置 Google 搜索查詢，包括地理定位參數、搜索類型以及「高級參數」輸出選項。

<details>

<summary><strong><code>q</code> ,</strong>搜尋查詢<strong>(必填)</strong></summary>

定義用於數據爬取的搜索查詢（默認值：`q=pizz`a）。支援任何語言的關鍵字。
\
範例請求：
\
使用參數 `q` 的範例：pizza

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

</details>

## 地理位置

<details>

<summary><strong><code>hl</code> ,</strong>語言<strong>(非必填)</strong></summary>

設定搜尋結果的介面語言（預設值：en）。採用標準語言代碼格式（例如：`en、es、zh-CN`）。
\
如需完整的支援語言代碼列表，請參考：[Google 語言代碼](https://developers.google.com/google-ads/api/docs/start)。

**範例請求**：

使用參數 q : pizza, hl : es 的範例結果

```sh
curl -X POST https://scraperapi.thordata.com/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"
```

</details>

<details>

<summary><strong><code>geo</code> ,</strong>位置<strong>(非必填)</strong></summary>

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

**範例請求：**

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

```
curl -X POST https://scraperapi.thordata.com/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"
```

</details>

<details>

<summary><strong><code>region</code>,</strong>地區<strong>(非必填)</strong></summary>

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

* `COUNTRY` - 國家
* `REGION` - 次區域
* `DMA` - 都會區
* `CITY` - 城市

**範例請求：**

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

```sh
curl -X POST https://scraperapi.thordata.com/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"
```

</details>

## 搜尋類型

<details>

<summary><code>data_type</code> <strong>,</strong>資料型別<strong>(非必填)</strong></summary>

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

* **`TIMESERIES`** - 時間趨勢分析：可接受單一或多個查詢
* **`GEO_MAP`** - 區域比較分析：僅接受多個查詢
* **`GEO_MAP_0`** - 區域興趣分佈：僅接受單一查詢
* **`RELATED_TOPICS`** - 相關主題：僅接受單一查詢
* **`RELATED_QUERIES`** - 相關查詢：僅接受單一查詢

**範例請求：**

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

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

</details>

## 高級參數

<details>

<summary><code>tz</code><strong>,</strong>時區<strong>(非必填)</strong></summary>

此參數用於設定時區偏移量。預設值為 **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 時區）

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

</details>

<details>

<summary><code>cat</code>,類別 <strong>(非必填)</strong></summary>

此參數用於設定搜尋類別。預設值為 **0**（所有類別）。

**範例請求：**

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

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

</details>

<details>

<summary><code>gprop</code> <strong>,</strong>財產<strong>(非必填)</strong></summary>

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

* **`images`** - 圖片搜尋
* **`news`** - 新聞搜尋
* **`froogle`** - Google 購物
* **`youtube`** - YouTube 搜尋

**範例請求：**

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

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

</details>

<details>

<summary><code>date</code> <strong>,</strong>日期<strong>(非必填)</strong></summary>

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

**預設時間範圍**：

* `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` 的搜尋結果

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

</details>

如需進一步幫助，請透過 **<support@thordata.com>** 聯繫我們。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.thordata.com/doc/zh-hk/pa-qu/serp-api/cha-xun-can-shu/gu-ge/google-trends.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.