게시물 언어(language 매개변수)

게시물을 필터링하는 모든 엔드포인트와 MCP 도구는 같은 매개변수 language로 조회할 게시물의 언어를 정합니다. 값은 ISO 언어 코드이며 대소문자를 구분하지 않습니다. 응답에는 항상 아래 표의 표기가 사용됩니다.

사용 가능한 값

값	범위
`zh`	모든 중국어 게시물: 번체, 간체, 광둥어(기본값)
`zh-Hant`	중국어(번체)(서면 중국어, 광둥어 제외)
`zh-Hans`	중국어(간체)
`yue`	광둥어: 광둥어 구어로 썼거나 광둥어가 섞인 게시물
`en`	영어
`ja`	일본어
`ko`	한국어

zh-Hant, zh-Hans, yue는 서로 겹치지 않으며, 셋을 합치면 zh와 같습니다.
**지정하지 않으면 기본값은 zh**이며 중국어 게시물만 반환됩니다(/post/inspiration은 예외, 아래 참고). 영어, 일본어, 한국어 게시물을 조회하려면 en, ja, ko를 명시적으로 지정하세요. 호출할 때마다 language를 명시하는 것을 권장합니다.
요청 한 번에 한 언어만 조회합니다. ‘모든 언어’ 옵션은 없으며, 결과에 다른 언어의 게시물이 섞이지 않습니다. 언어끼리 비교하려면 언어마다 한 번씩 호출하세요.

엔드포인트별 지원 언어

엔드포인트(MCP 도구)	사용 가능한 값	기본값
`/post/search`(`search_posts`), `/post/keyword-trend`(`get_keyword_trend`), `/post/hot`(`get_hot_posts`)	7개 모두	`zh`
`/post/semantic-search`(`semantic_search_posts`)	7개 모두	`zh`
`/leaderboard/cool-replies`(`get_cool_replies`), `/leaderboard/post-like-growth`(`get_post_like_growth`)	7개 모두	`zh`
`/leaderboard/follower-growth`(`get_follower_growth`)	7개 모두	`zh`
`/stats/follower-ladder`(`get_follower_ladder`), `/stats/like-ladder`(`get_like_ladder`), `/stats/power-hours`(`get_power_hours`)	7개 모두	`zh`
`/post/inspiration`(`get_inspiration`)	7개 모두	미지정 시 중국어·일본어·한국어
Webhook 규칙	`zh`, `zh-Hant`, `zh-Hans`, `yue`, `ja`, `ko`	`zh`

랭킹, 사다리, 황금 시간대는 언어별로 따로 계산합니다. 예를 들어 ja의 팔로워 수 사다리는 일본어 게시물 작성자만 대상으로 하며, 언어 간에 수치를 합치지 않습니다.
/post/inspiration(get_inspiration)에 language를 지정하지 않으면 결과는 중국어, 일본어, 한국어의 반응이 높은 게시물에서 가져오며 영어 게시물은 포함되지 않습니다. 영어 게시물은 en을 지정하세요.

광둥어 제외: `exclude_hk`

language=zh일 때 /post/search, /post/hot, /post/keyword-trend, /post/semantic-search에 exclude_hk=true를 추가하면 광둥어(yue) 게시물을 제외하며, zh-Hant와 zh-Hans를 합친 결과와 같습니다. 다른 언어에서는 이 매개변수가 필요 없습니다.

키워드 일치 방식

키워드 일치 방식은 언어마다 다릅니다. 중국어와 일본어는 한 글자씩, 한국어는 띄어쓰기로 구분된 단어 단위로 일치하며, 영어 게시물(en)은 대소문자를 구분하지 않고 단수·복수 같은 어형 변화도 함께 일치합니다. 자세한 내용은 검색 규칙을 참고하세요.