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