# 地區與語言（language 參數）

大部分端點都有 `language` 參數，用來決定要搜尋哪個市場的串文。預設是 `zh`（所有中文串文）。

## 可用的值

| `language` | 涵蓋範圍 |
| --- | --- |
| `zh` | 所有中文串文：繁體、簡體、粵語，以及無法判斷繁簡的中文（預設值） |
| `tw` | 繁體中文，以台灣為主。會排除以簡體字為主的串文 |
| `hk` | 粵語與港式中文 |
| `cn` | 以簡體字為主的中文 |
| `jp` | 日文 |
| `kr` | 韓文 |

`tw`、`hk`、`cn` 三者互不重疊，合起來等於 `zh`。

舊版的 `chinese`、`japanese`、`korean` 仍可使用，分別等同 `zh`、`jp`、`kr`。

## 排除香港：`exclude_hk`

`language=zh` 時可加上 `exclude_hk=true`，排除粵語與港式中文的串文。其他地區不需要這個參數。

## `tw` 與 `cn` 怎麼判斷

Throk 在查詢時逐篇檢查串文用字：簡體專用字比繁體專用字多的歸為 `cn`，其餘（包括繁簡通用、無法判斷的內容）歸為 `tw`。

因為檢查是在查詢當下進行，使用 `tw` 或 `cn` 時有兩點要注意：

- **`total_count` 是上限值。** 回傳的總數是檢查前的數量，實際符合的串文可能較少。
- **翻頁有上限。** `page × size × 3` 不能超過 10,000，否則會回傳 400。

## 關鍵字趨勢不支援 `tw` 與 `cn`

`/post/keyword-trend` 回傳的是彙總數量，無法逐篇檢查用字，因此只接受 `zh`、`hk`、`jp`、`kr`。想看台灣的趨勢，請用 `language=zh` 搭配 `exclude_hk=true`。