串文語言(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。 - 一次只查一種語言。 沒有「所有語言」的選項,結果也不會混入其他語言的串文。想比較不同語言,請每種語言各呼叫一次。
各端點支援的語言
Section titled “各端點支援的語言”| 端點(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
Section titled “排除粵語:exclude_hk”/post/search、/post/hot、/post/keyword-trend 與 /post/semantic-search 在 language=zh 時可加上 exclude_hk=true,排除粵語(yue)串文,結果等同 zh-Hant 加上 zh-Hans。其他語言不需要這個參數。
關鍵字怎麼比對
Section titled “關鍵字怎麼比對”各語言的關鍵字比對方式不同:中文與日文逐字比對,韓文以空格隔開的詞比對,英文串文(en)不分大小寫,並會合併單複數等詞形變化。詳見搜尋規則。