WeChatチャンネル API
WeChat Channelsは、WeChat内のショート動画フィードです。searchはキーワードで動画を検索し、user_postsはアカウントの最新動画を一覧表示します。videoは数値IDで1本の動画を取得し、profileはアカウントの公開情報を取得します。
user_postsとvideoは、各行のIDを使って連携できます。idはvideoのobject_idとして、author_username（v2_...@finder）はuser_postsのusernameとして使います。検索結果の行にはどちらのIDも含まれないため、検索結果をvideoやuser_postsで開くことはできません。動画ファイルのリンクは約1日で失効し、各ファイルの先頭部分は暗号化されています。復号にはvideo_decode_keyを使います。
プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
WeChatチャンネルの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | keywordでWeChat Channelsの動画を検索し、約10件の結果を1ページ分取得します。各結果にはタイトル、カバー画像、再生時間、いいね数、公開日時、投稿者の名前、アバター、認証フラグが含まれます。検索結果には動画IDとアカウントIDが含まれないため、videoやuser_postsには渡せません。 | 1,000リクエストあたり$60 | 正常 |
動画の詳細video | WeChat Channelsの動画1本をobject_idで取得します。object_idには、user_postsの各行で返される数値IDか、動画の共有リンク（https://weixin.qq.com/sph/…）を指定します。タイトル、説明、投稿者、公開日時、いいね数、保存数、シェア数、コメント数、再生時間、フレームサイズ、カバー画像、有効期限付きの動画ファイルリンクとその復号キーを取得できます。共有リンクで取得した場合、title、video_width、video_heightが欠落することがあり、descriptionに投稿の全文が含まれます。like_countとcollect_countは、10,000を超えると百の位までの精度となり、末尾は常に02になります。100,000以上では常に100002です。share_countは正確な値です。comment_countは、10,000を超えると百の位までの値（末尾は02）になることがあり、それ以外は正確な値です。ファイルリンクの有効期限は約1日です。 | 1,000リクエストあたり$6.81 | 正常 |
ユーザーの投稿user_posts | WeChat Channelsアカウント1件の最新15本の動画を、username（v2_...@finder形式のID）で取得します。各動画にはID、タイトル、説明、公開日時、いいね数、保存数、シェア数、コメント数、再生時間、フレームサイズ、カバー画像、有効期限付きの動画ファイルリンクと、その復号に必要なキーが含まれます。アカウントIDはニックネームではありません。 | 1,000リクエストあたり$46 | 正常 |
プロフィールprofile | v2_...@finder形式のIDでWeChat Channelsのアカウントを検索します。表示名、プロフィール文、アバター、地域、動画数とコレクション数、ライブ配信時間、認証に関する説明、公式アカウントなどの連携WeChatアカウントを取得できます。Channelsのプロフィールでは通常フォロワー数が非表示のため、follower_countは多くの場合含まれません。いいね、お気に入り、シェアの合計数は提供されません。 | 1,000リクエストあたり$8 | 正常 |
コメントcomments | 数値IDまたは共有リンクを指定して、WeChat Channelsの動画1件のトップレベルコメントを1ページあたり最大25件取得します。各コメントには、本文、いいね数、日時、コメント投稿者のIPの地域、名前、アバターが含まれ、Channelsアカウントを持っている場合はそのIDも含まれます。次のページはnext_page_tokenで取得します。 | 1,000リクエストあたり$8 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
WeChatチャンネルの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索
| keyword | — | Sync配信 | — | 1,000リクエストあたり$60 | search_rank · title · cover_url · duration_sec · duration_seconds · posted_at · like_count · author_name · author_avatar_url · author_is_verified · platform |
video動画の詳細 WeChat Channelsの動画1本を | object_id | — | Sync配信 | — | 1,000リクエストあたり$6.81 | id · author_username · author_name · title · description · posted_at · like_count · collect_count · share_count · comment_count · duration_sec · duration_seconds · video_width · video_height · cover_url · video_url · video_decode_key · platform |
user_postsユーザーの投稿 WeChat Channelsアカウント1件の最新15本の動画を、 | username | — | Sync配信 | — | 1,000リクエストあたり$46 | id · author_username · author_name · title · description · posted_at · like_count · collect_count · share_count · comment_count · duration_sec · duration_seconds · video_width · video_height · cover_url · video_url · video_decode_key · platform |
profileプロフィール v2_...@finder形式のIDでWeChat Channelsのアカウントを検索します。表示名、プロフィール文、アバター、地域、動画数とコレクション数、ライブ配信時間、認証に関する説明、公式アカウントなどの連携WeChatアカウントを取得できます。Channelsのプロフィールでは通常フォロワー数が非表示のため、 | username | — | Sync配信 | — | 1,000リクエストあたり$8 | username · display_name · bio · avatar_url · region · follower_count · post_count · collection_count · live_duration_hours · verified_reason · linked_accounts · platform |
commentsコメント 数値IDまたは共有リンクを指定して、WeChat Channelsの動画1件のトップレベルコメントを1ページあたり最大25件取得します。各コメントには、本文、いいね数、日時、コメント投稿者のIPの地域、名前、アバターが含まれ、Channelsアカウントを持っている場合はそのIDも含まれます。次のページはnext_page_tokenで取得します。 | object_id | page_token | Sync配信 | 1回の呼び出しで最大25行の1ページを返します。行数はページごとに異なるため、行数が少なくても最後のページとは限りません。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡し、next_page_tokenがなくなったら終了します。limitは指定できますが、効果はありません。 | 1,000リクエストあたり$8 | id · text · like_count · posted_at · author_username · author_name · author_avatar_url · ip_location · next_page_token · platform |
WeChatチャンネルのsearchのパラメータはそれぞれどういう意味ですか？
keywordでWeChat Channelsの動画を検索し、約10件の結果を1ページ分取得します。各結果にはタイトル、カバー画像、再生時間、いいね数、公開日時、投稿者の名前、アバター、認証フラグが含まれます。検索結果には動画IDとアカウントIDが含まれないため、videoやuser_postsには渡せません。
keyword必須searchで使うWeChat Channelsの検索キーワードです（例：coffee）。中国語のキーワードのほうが多くの動画にマッチする傾向があります。1回の呼び出しで約10件の動画を1ページ分返します。
WeChatチャンネルのvideoのパラメータはそれぞれどういう意味ですか？
WeChat Channelsの動画1本をobject_idで取得します。object_idには、user_postsの各行で返される数値IDか、動画の共有リンク（https://weixin.qq.com/sph/…）を指定します。タイトル、説明、投稿者、公開日時、いいね数、保存数、シェア数、コメント数、再生時間、フレームサイズ、カバー画像、有効期限付きの動画ファイルリンクとその復号キーを取得できます。共有リンクで取得した場合、title、video_width、video_heightが欠落することがあり、descriptionに投稿の全文が含まれます。like_countとcollect_countは、10,000を超えると百の位までの精度となり、末尾は常に02になります。100,000以上では常に100002です。share_countは正確な値です。comment_countは、10,000を超えると百の位までの値（末尾は02）になることがあり、それ以外は正確な値です。ファイルリンクの有効期限は約1日です。
object_id必須videoで使う、WeChat Channelsの動画1件の数値IDです（例：15039881603147501275）。user_postsまたはvideoの行のidから取得するか、動画の共有リンク（https://weixin.qq.com/sph/...）を指定します。検索結果の行にはどちらも含まれません。それ以外の形式は課金前に拒否されます。WeChat Open Docs：Channels動画の一意のID「feedId」 — WeChatの開発者ドキュメントによると、ミニプログラムはfeedIdを使ってChannels動画を開き、投稿者はこのfeedIdをChannelsアシスタントからコピーします。この資料で確認できるのは、各Channels動画に固有のIDがあることのみです。このAPIのobject_idはuser_postsまたはvideoの行から取得する、数字のみで構成される別形式のIDで、feedIdと相互に置き換えることはできません。 · 確認日
WeChatチャンネルのuser_postsのパラメータはそれぞれどういう意味ですか？
WeChat Channelsアカウント1件の最新15本の動画を、username（v2_...@finder形式のID）で取得します。各動画にはID、タイトル、説明、公開日時、いいね数、保存数、シェア数、コメント数、再生時間、フレームサイズ、カバー画像、有効期限付きの動画ファイルリンクと、その復号に必要なキーが含まれます。アカウントIDはニックネームではありません。
username必須user_postsで使うWeChat ChannelsのアカウントIDで、v2_...@finderの形式です。user_postsまたはvideoの行のauthor_usernameから取得するか、チャンネルページに表示されるsphで始まるチャンネルID（例：sphi9BjV8GK0Zsl）を指定します。ニックネームではありません。また、検索結果の行には含まれません。それ以外の形式は課金前に拒否されます。WeChat Open Docs：ChannelsのアカウントID（finderUserName） — WeChatの開発者ドキュメントによると、finderUserNameはChannelsのアカウントIDで、Channelsアシスタントのホームページで投稿者に表示されます。この資料で確認できるのは、Channelsアカウントにニックネームとは別のIDがあることのみです。このAPIのusernameはuser_postsまたはvideoの行から取得するv2_...@finder形式のアカウントIDで、そのホームページに表示されるIDと相互に置き換えることはできません。 · 確認日
WeChatチャンネルのprofileのパラメータはそれぞれどういう意味ですか？
v2_...@finder形式のIDでWeChat Channelsのアカウントを検索します。表示名、プロフィール文、アバター、地域、動画数とコレクション数、ライブ配信時間、認証に関する説明、公式アカウントなどの連携WeChatアカウントを取得できます。Channelsのプロフィールでは通常フォロワー数が非表示のため、follower_countは多くの場合含まれません。いいね、お気に入り、シェアの合計数は提供されません。
username必須profileで使用するWeChat ChannelsのアカウントIDです。v2_...@finder形式で、user_postsまたはvideoの行のauthor_usernameから取得できます。チャンネルページに表示されるsphで始まるチャンネルID（例：sphi9BjV8GK0Zsl）も使用できます。ニックネームではありません。また、検索結果の行にはこの値は含まれません。
WeChatチャンネルのcommentsのパラメータはそれぞれどういう意味ですか？
数値IDまたは共有リンクを指定して、WeChat Channelsの動画1件のトップレベルコメントを1ページあたり最大25件取得します。各コメントには、本文、いいね数、日時、コメント投稿者のIPの地域、名前、アバターが含まれ、Channelsアカウントを持っている場合はそのIDも含まれます。次のページはnext_page_tokenで取得します。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況object_id必須- コメントを取得するWeChat Channels動画の数値ID（例：
15039881603147501275）、または動画の共有リンク（https://weixin.qq.com/sph/...）を指定します。数値IDは、user_postsまたはvideoの行のidから取得できます。 page_token任意comments用のページトークンです。最初のページでは省略し、以降は同じ動画に対して、前回のレスポンスのnext_page_tokenを受け取ったとおりにそのまま渡します。1ページにつき1回の呼び出しです。最後のページにはnext_page_tokenがありません。
WeChatチャンネル APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"wechat_channels","action":"search","params":{"keyword":"<keyword>"}}'
WeChatチャンネル APIに関する質問
WeChatチャンネル APIでは何を取得できますか？
platformをwechat_channelsに設定します。現在のカタログには検索、動画の詳細、ユーザーの投稿、プロフィール、コメントが掲載されています。これらのアクション名はそれぞれ異なるWeChatチャンネルのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
WeChatチャンネルのsearchリクエストを開始するには、どの入力を使用しますか？
searchで使うWeChat Channelsの検索キーワードです（例：coffee）。中国語のキーワードのほうが多くの動画にマッチする傾向があります。1回の呼び出しで約10件の動画を1ページ分返します。params内のkeywordとして送信してください。
WeChatチャンネルのsearchはどのフィールドを返しますか？
宣言されたスキーマにはsearch_rank、title、cover_url、duration_secが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
WeChatチャンネルのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。