我们自己的访问统计默认开启。Google Analytics 只在你同意后启用,用来了解公开页面是否有用,不统计登录后的工作台。详见 隐私政策。

微信视频号

微信视频号 API

按关键词搜索视频号视频,按账号 ID 读取最新 15 条视频,按视频 ID 读取单条详情:点赞、收藏、转发等互动计数,时长、封面和视频文件地址;搜索结果不带视频 ID 和账号 ID,不能接着查详情或账号。 调用 POST /api/v1/social ;返回结构化 JSON,$6.81 / 千次–$60 / 千次;失败不计费。

平台运行状态

24h 健康值
正常
正常

30 天趋势

微信视频号 能力清单

能力做什么单价24 小时运行状态
关键词搜索search用 search 按关键词搜视频号视频,一次一页、约 10 条。$60 / 千次正常
视频详情video用 video 按纯数字视频 ID 读单条视频的详情和互动计数。$6.81 / 千次正常
用户内容user_posts用 user_posts 按账号 ID 读这个账号最新的 15 条视频,连同互动计数和视频文件地址。$46 / 千次正常

点能力名进它的文档:参数、返回字段、代码示例和试用。

微信视频号 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

能力必填参数可选参数单次条数模式单价返回字段
searchkeyword——同步$60 / 千次search_rank · title · cover_url · duration_sec · duration_seconds · posted_at · like_count · author_name · author_avatar_url · author_is_verified · platform
videoobject_id——同步$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_postsusername——同步$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

怎么调用 微信视频号 视频详情 API?

video

使用 platform="wechat_channels"、action="video" 调用“视频详情”能力;返回单个对象,主要包含 id、author_username、author_name、title、description、posted_at 等 18 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

微信视频号 video 的参数分别是什么意思?

object_id必填
要读的视频 ID,纯数字(例如 15039881603147501275),取自 user_posts 或 video 返回行的 id;搜索结果里没有。

微信开放文档说明小程序打开视频号视频时用 feedId 标识一条视频,feedId 由作者在视频号助手里复制。这里只确认视频号的每条视频有自己的唯一标识;本接口的 object_id 是另一种纯数字写法,取自 user_posts 或 video 返回行,不能和 feedId 互换。官方来源:微信开放文档:视频号视频的唯一标识 feedId来源核查:

微信视频号 返回字段与含义(9)
cover_url
视频封面图链接(带签名,会过期)。
duration_sec
视频时长(秒)。
id
视频 ID(user_posts / video),纯数字字符串;作为 video 的 object_id 传回可读这条视频。
author_username
作者的视频号账号 ID,形如 v2_…@finder(user_posts / video);作为 user_posts 的 username 传回可读这个账号的视频。
collect_count
收藏数(user_posts / video)。
video_url
视频文件地址(user_posts / video;带签名,约 24 小时内有效)。视频号对文件开头一段做了加密,直接下载的文件不能播放,要先用 video_decode_key 解密。
video_decode_key
解密视频文件开头那段加密内容用的密钥(user_posts / video),和 video_url 配套。
video_width
视频画面宽度(像素)。
video_height
视频画面高度(像素)。

怎么调用 微信视频号 用户内容 API?

user_posts

使用 platform="wechat_channels"、action="user_posts" 调用“用户内容”能力;返回列表,主要包含 id、author_username、author_name、title、description、posted_at 等 18 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

微信视频号 user_posts 的参数分别是什么意思?

username必填
账号 ID,形如 v2_…@finder,取自 user_posts 或 video 返回行的 author_username;不是昵称,搜索结果里没有。每次返回这个账号最新的 15 条视频。

微信开放文档说明 finderUserName 代表视频号 ID,作者登录视频号助手后在首页可以看到。这里只确认视频号账号有独立于昵称的 ID;本接口的 username 是 v2_…@finder 形式的账号 ID,取自 user_posts 或 video 返回行,不能和视频号助手首页的 ID 互换。官方来源:微信开放文档:视频号 ID(finderUserName)来源核查:

微信视频号 返回字段与含义(9)
cover_url
视频封面图链接(带签名,会过期)。
duration_sec
视频时长(秒)。
id
视频 ID(user_posts / video),纯数字字符串;作为 video 的 object_id 传回可读这条视频。
author_username
作者的视频号账号 ID,形如 v2_…@finder(user_posts / video);作为 user_posts 的 username 传回可读这个账号的视频。
collect_count
收藏数(user_posts / video)。
video_url
视频文件地址(user_posts / video;带签名,约 24 小时内有效)。视频号对文件开头一段做了加密,直接下载的文件不能播放,要先用 video_decode_key 解密。
video_decode_key
解密视频文件开头那段加密内容用的密钥(user_posts / video),和 video_url 配套。
video_width
视频画面宽度(像素)。
video_height
视频画面高度(像素)。
微信视频号 search 调用流程一次 微信视频号 search 调用的全过程:向 POST /api/v1/social 发送 platform="wechat_channels"、action="search",以及必填参数 keyword;返回结构化 JSON,含 search_rank、title、cover_url、duration_sec、duration_seconds 等字段;返回列表,计费 $60 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "wechat_channels"action: "search"keywordEveryInfra$60 / 千次2 · 响应 · 列表search_ranktitlecover_urlduration_secduration_seconds
一次 微信视频号 search 调用的全过程:向 POST /api/v1/social 发送 platform="wechat_channels"、action="search",以及必填参数 keyword;返回结构化 JSON,含 search_rank、title、cover_url、duration_sec、duration_seconds 等字段;返回列表,计费 $60 / 千次,失败与空结果不计费。

微信视频号 原始字段名

EveryInfra 统一字段名

左边是 微信视频号 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。91 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

微信视频号 的独有字段名(当前目录)

全站 91 个平台的当前目录中,这 1 个字段名只在 微信视频号 出现。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • video_decode_key

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

search_rank
在这次搜索结果里的名次,从 1 开始(search)。
title
标题。平台无标题概念时(如纯文本帖)为 null。
cover_url
视频封面图链接(带签名,会过期)。
duration_sec
视频时长(秒)。
duration_seconds
时长,单位秒。非视频/音频内容为 null。
posted_at
发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
like_count
点赞数。null 表示该平台或该接口不公开此数据,不等于 0。
author_name
作者昵称(显示名)。
author_avatar_url
作者头像图片链接(多数平台带签名、会过期)。
author_is_verified
作者是否认证(search)。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
id
视频 ID(user_posts / video),纯数字字符串;作为 video 的 object_id 传回可读这条视频。
author_username
作者的视频号账号 ID,形如 v2_…@finder(user_posts / video);作为 user_posts 的 username 传回可读这个账号的视频。
description
简介或描述,通常比 text 短。
collect_count
收藏数(user_posts / video)。
share_count
分享/转发数。null 表示不公开,不等于 0。
comment_count
评论数。null 表示不公开,不等于 0。
video_width
视频画面宽度(像素)。
video_height
视频画面高度(像素)。
video_url
视频文件地址(user_posts / video;带签名,约 24 小时内有效)。视频号对文件开头一段做了加密,直接下载的文件不能播放,要先用 video_decode_key 解密。
video_decode_key
解密视频文件开头那段加密内容用的密钥(user_posts / video),和 video_url 配套。

请求填写示例

这里按关键词搜视频号视频;搜索结果不带视频 ID 和账号 ID,单条视频和账号视频要用 user_posts / video 返回行里的 id、author_username。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

wechat_channels_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"wechat_channels","action":"search","params":{"keyword":"咖啡"}}'

记录字段预览(非真实响应)

仅展示 search 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "search_rank": null,
  "title": null,
  "cover_url": null,
  "duration_sec": null,
  "duration_seconds": null,
  "posted_at": null,
  "like_count": null,
  "author_name": null,
  "author_avatar_url": null,
  "author_is_verified": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

微信视频号搜索 API 如何按关键词找视频?

用 search 按关键词搜视频号视频,一次一页、约 10 条。

查看 search 的 keyword 参数
  • keyword 填搜索词(如 咖啡);每行有 search_rank、title、cover_url、duration_sec、posted_at、like_count 和作者的 author_name、author_avatar_url、author_is_verified。点赞数原文是「1.2万」这类写法时,like_count 换成整数,原文在 like_count_display。
  • 搜索结果没有视频 ID 和账号 ID,不能接着查 video 或 user_posts;要读某个账号的视频,需要它的 v2_…@finder 账号 ID。

微信视频号账号视频 API 如何读一个账号最新发布的视频?

用 user_posts 按账号 ID 读这个账号最新的 15 条视频,连同互动计数和视频文件地址。

查看 user_posts 的 username 参数
  • username 填 v2_…@finder 形式的账号 ID,取自 user_posts 或 video 返回行的 author_username;昵称会在扣费前被拒。
  • 每行有 id、title、description、posted_at、like_count、collect_count、share_count、comment_count、duration_sec、cover_url、video_url 与 video_decode_key;video_url 约 24 小时内有效,文件开头一段是加密的,要用 video_decode_key 解密后才能播放。行上的 id 可以交给 video。

微信视频号视频详情 API 如何按视频 ID 读一条视频?

用 video 按纯数字视频 ID 读单条视频的详情和互动计数。

查看 video 的 object_id 参数
  • object_id 填纯数字视频 ID(如 15039881603147501275),取自 user_posts 或 video 返回行的 id;不是数字的会在扣费前被拒。
  • 返回字段与 user_posts 的行相同:标题、描述、作者、发布时间、点赞、收藏、转发、评论数、时长、画面宽高、封面和带解密密钥的视频文件地址。

微信视频号 API 常见问题

微信视频号 API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="wechat_channels"、action 和 params。以 search 为例,必填 keyword,没有可选参数。这里按关键词搜视频号视频;搜索结果不带视频 ID 和账号 ID,单条视频和账号视频要用 user_posts / video 返回行里的 id、author_username。 微信视频号 共 3 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 91 个平台。

微信视频号 API 怎么收费?

$6.81 / 千次–$60 / 千次,按能力不同(清单里逐条标了)。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 16 次 微信视频号 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

微信视频号 API 一次能返回多少条数据?

微信视频号 有 2 个列表接口,包括 search、user_posts。其余 1 个接口返回单个对象;对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

微信视频号 API 返回哪些字段?

当前目录为 search 列出 search_rank、title、cover_url、duration_sec、duration_seconds、posted_at 等 11 个字段名。按全站当前目录统计,1 个字段名只在 微信视频号 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

微信视频号搜索 API 如何按关键词找视频?

用 search 按关键词搜视频号视频,一次一页、约 10 条。 keyword 填搜索词(如 咖啡);每行有 search_rank、title、cover_url、duration_sec、posted_at、like_count 和作者的 author_name、author_avatar_url、author_is_verified。点赞数原文是「1.2万」这类写法时,like_count 换成整数,原文在 like_count_display。 搜索结果没有视频 ID 和账号 ID,不能接着查 video 或 user_posts;要读某个账号的视频,需要它的 v2_…@finder 账号 ID。

微信视频号账号视频 API 如何读一个账号最新发布的视频?

用 user_posts 按账号 ID 读这个账号最新的 15 条视频,连同互动计数和视频文件地址。 username 填 v2_…@finder 形式的账号 ID,取自 user_posts 或 video 返回行的 author_username;昵称会在扣费前被拒。 每行有 id、title、description、posted_at、like_count、collect_count、share_count、comment_count、duration_sec、cover_url、video_url 与 video_decode_key;video_url 约 24 小时内有效,文件开头一段是加密的,要用 video_decode_key 解密后才能播放。行上的 id 可以交给 video。

微信视频号视频详情 API 如何按视频 ID 读一条视频?

用 video 按纯数字视频 ID 读单条视频的详情和互动计数。 object_id 填纯数字视频 ID(如 15039881603147501275),取自 user_posts 或 video 返回行的 id;不是数字的会在扣费前被拒。 返回字段与 user_posts 的行相同:标题、描述、作者、发布时间、点赞、收藏、转发、评论数、时长、画面宽高、封面和带解密密钥的视频文件地址。

可以先免费试用 微信视频号 API 吗?

可以。注册免费,在 GitHub 给 everyinfra/everyinfra-agent-plugins 点星,就能在控制台「余额与充值」领取 $1 额度(≈720 次数据调用),直接进赠送余额,不用输码,24 小⁠时内有效。请先选择 微信视频号 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 3 个能力。无需信用卡。

开始调用 微信视频号 API

在 GitHub 点星领 $1 额度,注册后在控制台领取,直接进赠送余额,24 小⁠时内有效,先选一个 微信视频号 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始