# 지역과 언어(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`를 함께 사용하세요.