# 地域と言語（language パラメータ）

ほとんどのエンドポイントには `language` パラメータがあり、どの市場の投稿を検索するかを指定できます。デフォルトは `zh`（すべての中国語の投稿）です。

## 指定できる値

| `language` | 対象範囲 |
| --- | --- |
| `zh` | すべての中国語の投稿：繁体字、簡体字、広東語、および繁体字か簡体字か判別できない中国語（デフォルト） |
| `tw` | 繁体字中国語（主に台湾）。簡体字が中心の投稿は除外 |
| `hk` | 広東語と香港式中国語 |
| `cn` | 簡体字が中心の中国語 |
| `jp` | 日本語 |
| `kr` | 韓国語 |

`tw`、`hk`、`cn` の 3 つは互いに重複せず、合わせると `zh` と同じになります。

従来の `chinese`、`japanese`、`korean` も引き続き使えます。それぞれ `zh`、`jp`、`kr` と同じです。

## 香港を除外する：`exclude_hk`

`language=zh` の場合に `exclude_hk=true` を付けると、広東語と香港式中国語の投稿を除外できます。その他の地域では、このパラメータは不要です。

## `tw` と `cn` の判定方法

Throk は照会時に投稿の用字を 1 件ずつ確認します。簡体字専用の文字が繁体字専用の文字より多い投稿は `cn` に、それ以外（繁体字・簡体字に共通の文字だけの内容や判別できない内容を含む）は `tw` に分類されます。

判定は照会の時点で行われるため、`tw` または `cn` を使う場合は次の 2 点に注意してください。

- **`total_count` は上限値です。** 返される総数は判定前の件数で、実際に該当する投稿はそれより少ないことがあります。
- **ページ送りに上限があります。** `page × size × 3` が 10,000 を超えると、400 が返されます。

## キーワードトレンドは `tw` と `cn` に非対応

`/post/keyword-trend` は集計済みの件数を返すため、投稿ごとに用字を確認できません。そのため `zh`、`hk`、`jp`、`kr` のみ指定できます。台湾のトレンドを見たい場合は、`language=zh` と `exclude_hk=true` を組み合わせてください。