コンテンツにスキップ

投稿の言語(language パラメータ)

投稿を絞り込むすべてのエンドポイントと MCP ツールは、同じ language パラメータで照会する投稿の言語を決めます。値は ISO の言語コードで、大文字と小文字は区別しません。レスポンスでは常に下表の表記が使われます。

値 対象範囲
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 を指定してください。

language=zh の場合、/post/search、/post/hot、/post/keyword-trend、/post/semantic-search に exclude_hk=true を付けると広東語(yue)の投稿を除外でき、zh-Hant と zh-Hans を合わせた結果と同じになります。その他の言語では、このパラメータは不要です。

キーワードの一致方法は言語によって異なります。中国語と日本語は 1 文字ずつ、韓国語はスペースで区切られた語で一致し、英語の投稿(en)は大文字と小文字を区別せず、単数形・複数形などの語形変化もまとめて一致します。詳しくは検索ルールをご覧ください。