投稿の言語(language パラメータ)
投稿を絞り込むすべてのエンドポイントと MCP ツールは、同じ language パラメータで照会する投稿の言語を決めます。値は ISO の言語コードで、大文字と小文字は区別しません。レスポンスでは常に下表の表記が使われます。
指定できる値
Section titled “指定できる値”| 値 | 対象範囲 |
|---|---|
zh |
すべての中国語の投稿:繁体字、簡体字、広東語(デフォルト) |
zh-Hant |
繁体字中国語(書き言葉の中国語。広東語は含まない) |
zh-Hans |
簡体字中国語 |
yue |
広東語:広東語の口語で書かれた投稿、または広東語が混ざった投稿 |
en |
英語 |
ja |
日本語 |
ko |
韓国語 |
zh-Hant、zh-Hans、yueの 3 つは互いに重複せず、合わせるとzhと同じになります。- 指定しない場合のデフォルトは
zhで、中国語の投稿だけが返されます(/post/inspirationは例外。下記を参照)。英語・日本語・韓国語の投稿を照会するには、en、ja、koを明示的に指定してください。呼び出しのたびにlanguageを明示することをおすすめします。 - 1 回のリクエストで照会できるのは 1 言語だけです。「すべての言語」の選択肢はなく、結果に他の言語の投稿が混ざることもありません。言語どうしを比較するときは、言語ごとに 1 回ずつ呼び出してください。
エンドポイントごとの対応言語
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”language=zh の場合、/post/search、/post/hot、/post/keyword-trend、/post/semantic-search に exclude_hk=true を付けると広東語(yue)の投稿を除外でき、zh-Hant と zh-Hans を合わせた結果と同じになります。その他の言語では、このパラメータは不要です。
キーワードの一致方法
Section titled “キーワードの一致方法”キーワードの一致方法は言語によって異なります。中国語と日本語は 1 文字ずつ、韓国語はスペースで区切られた語で一致し、英語の投稿(en)は大文字と小文字を区別せず、単数形・複数形などの語形変化もまとめて一致します。詳しくは検索ルールをご覧ください。