微信视频号 API

覆盖视频搜索、详情、评论、分享链接、账号信息和账号作品。

能力	REST 路径	方法	积分/次	MCP 工具
视频搜索	`/v1/wechat_channels/video_search`	POST	13	`wechat_channels_video_search`
视频详情	`/v1/wechat_channels/video_detail`	POST	10	`wechat_channels_video_detail`
视频评论	`/v1/wechat_channels/video_comments`	POST	13	`wechat_channels_video_comments`
视频分享链接	`/v1/wechat_channels/video_share_url`	POST	13	`wechat_channels_video_share_url`
账号信息	`/v1/wechat_channels/user_profile`	POST	13	`wechat_channels_user_profile`
账号作品	`/v1/wechat_channels/user_videos`	POST	13	`wechat_channels_user_videos`

视频号搜索

视频号号内搜索作品

REST 路径: /v1/wechat_channels/video_search
方法: POST
MCP 工具: wechat_channels_video_search
计费: 13 积分/次，仅成功返回数据时扣费

参数	类型	必填	说明
`username`	string	是	创作者 finder username（v2_…@finder 格式）/Creator finder username (v2_…@finder format)
`keyword`	string	是	在该号内搜索的关键词（1-100 字）/Keyword to search within this channel (1-100 chars)
`raw`	boolean	否	True=原始响应；False=精简解析结构/True=raw response; False=simplified parsed structure

请求示例

curl -X POST "https://api.example.com/v1/wechat_channels/video_search" \
  -H "X-API-Key: $FIREFLY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Request-Id: demo-wechat_channels_video_search-001" \
  -d '{
  "username": "ACCOUNT_NAME",
  "keyword": "coffee"
}'

视频号作品详情

获取视频号作品详情

REST 路径: /v1/wechat_channels/video_detail
方法: POST
MCP 工具: wechat_channels_video_detail
计费: 10 积分/次，仅成功返回数据时扣费

参数	类型	必填	说明
`object_id`	string	至少提供：object_id / export_id / share_url	作品 objectId（纯数字，最优先）/Video objectId (numeric, highest priority)
`export_id`	string	至少提供：object_id / export_id / share_url	搜索结果中的 exportId（export/ 开头，会过期，需尽快使用）/exportId from search results (starts with
`object_nonce_id`	string	否	配套 objectNonceId（纯数字，可选，提升命中率）/Optional objectNonceId (numeric, improves hit rat
`share_url`	string	至少提供：object_id / export_id / share_url	视频号分享短链（https://weixin.qq.com/sph/…），仅在 object_id 与 export_id 都为空时使用/Share URL (
`raw`	boolean	否	True=原始响应；False=精简解析结构（推荐做媒体下载）/True=raw response; False=simplified parsed struc

请求示例

curl -X POST "https://api.example.com/v1/wechat_channels/video_detail" \
  -H "X-API-Key: $FIREFLY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Request-Id: demo-wechat_channels_video_detail-001" \
  -d '{
  "object_id": "14990093036440061965"
}'

视频号作品评论

获取视频号作品评论

REST 路径: /v1/wechat_channels/video_comments
方法: POST
MCP 工具: wechat_channels_video_comments
计费: 13 积分/次，仅成功返回数据时扣费

参数	类型	必填	说明
`object_id`	string	是	作品 objectId（纯数字）/Video objectId (numeric)
`last_buffer`	string	否	翻页游标（base64），首页留空/Pagination cursor (base64), leave empty for first page
`comment_id`	string	否	展开某条评论的二级回复时传其 commentId（纯数字），首页留空/Pass a commentId (numeric) to expand its repl
`raw`	boolean	否	True=原始响应；False=精简解析结构/True=raw response; False=simplified parsed structure

请求示例

curl -X POST "https://api.example.com/v1/wechat_channels/video_comments" \
  -H "X-API-Key: $FIREFLY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Request-Id: demo-wechat_channels_video_comments-001" \
  -d '{
  "object_id": "14990093036440061965"
}'

视频号作品分享链接

根据视频号作品 objectId 生成可点击分享链接

REST 路径: /v1/wechat_channels/video_share_url
方法: POST
MCP 工具: wechat_channels_video_share_url
计费: 13 积分/次，仅成功返回数据时扣费

参数	类型	必填	说明
`object_id`	string	是	作品 objectId（纯数字，来自视频详情或账号作品列表）/Video objectId (numeric, from video detail or user videos)
`raw`	boolean	否	True=原始响应；False=精简解析结构/True=raw response; False=simplified parsed structure

请求示例

curl -X POST "https://api.example.com/v1/wechat_channels/video_share_url" \
  -H "X-API-Key: $FIREFLY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Request-Id: demo-wechat_channels_video_share_url-001" \
  -d '{
  "object_id": "14990093036440061965"
}'

视频号账号信息

获取视频号账号主页资料与统计

REST 路径: /v1/wechat_channels/user_profile
方法: POST
MCP 工具: wechat_channels_user_profile
计费: 13 积分/次，仅成功返回数据时扣费

参数	类型	必填	说明
`username`	string	是	视频号 finder username（v2_…@finder 格式）/WeChat Channels finder username (v2_…@finder
`raw`	boolean	否	True=原始响应；False=精简解析结构/True=raw response; False=simplified parsed structure

请求示例

curl -X POST "https://api.example.com/v1/wechat_channels/user_profile" \
  -H "X-API-Key: $FIREFLY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Request-Id: demo-wechat_channels_user_profile-001" \
  -d '{
  "username": "ACCOUNT_NAME"
}'

视频号账号作品

获取视频号用户作品列表

REST 路径: /v1/wechat_channels/user_videos
方法: POST
MCP 工具: wechat_channels_user_videos
计费: 13 积分/次，仅成功返回数据时扣费

参数	类型	必填	说明
`username`	string	是	视频号 finder username（v2_…@finder 格式）/WeChat Channels finder username (v2_…@finder
`last_buffer`	string	否	翻页游标（base64），首页留空/Pagination cursor (base64), leave empty for first page
`raw`	boolean	否	True=原始响应；False=精简解析结构（推荐做媒体下载）/True=raw response; False=simplified parsed struc

请求示例

curl -X POST "https://api.example.com/v1/wechat_channels/user_videos" \
  -H "X-API-Key: $FIREFLY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Request-Id: demo-wechat_channels_user_videos-001" \
  -d '{
  "username": "ACCOUNT_NAME"
}'

微信视频号 API

On this page