跳到內容

串文語言(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。

/post/search、/post/hot、/post/keyword-trend 與 /post/semantic-search 在 language=zh 時可加上 exclude_hk=true,排除粵語(yue)串文,結果等同 zh-Hant 加上 zh-Hans。其他語言不需要這個參數。

各語言的關鍵字比對方式不同:中文與日文逐字比對,韓文以空格隔開的詞比對,英文串文(en)不分大小寫,並會合併單複數等詞形變化。詳見搜尋規則。