微信视频号 / WeChat Channels API - 热搜、搜索、评论、用户数据

这是社媒数据助手 SocialDataX 的 Apify Actor 适配层，提供只读微信视频号 / WeChat Channels data API。

用户在 Apify 上运行时不需要配置 SocialDataX API Key。API Key 由 Actor owner 在 Apify secret / environment 中配置。

支持能力 / Operations

• 热搜 / hot list
• 视频搜索 / video search
• 视频详情 / video details
• 评论列表 / comments
• 评论回复 / comment replies
• 用户资料 / creator profile
• 用户视频列表 / creator videos

默认 operation 是 search_videos，默认关键词是 露营。

输入字段 / Input

Operation	必填字段	可选字段	说明
search_hot_list	无	max_items	获取微信视频号热榜数据，请求一次并按 max_items 限制写入 Dataset。
search_videos	keyword	sort_type, duration_range, page_token, max_items, auto_paginate	按关键词搜索视频号内容，默认自动翻页直到达到 max_items。
get_video_detail	url 或 encrypted_object_id	无	获取单条视频详情；只能二选一，不要两个都填。
get_video_comments	url 或 object_id + object_nonce_id	page_token, max_items, auto_paginate	获取一级评论列表；只能二选一，不要同时填视频链接和 ID 组合。
get_video_comment_replies	object_id, object_nonce_id, comment_id	page_token, max_items, auto_paginate	获取一级评论下的回复。先运行评论列表，从 Dataset 行里复制真实 ID。
get_user_info	user_id	无	获取微信视频号用户资料。user_id 应以 @finder 结尾。
list_user_videos	user_id 或 url	page_token, max_items, auto_paginate	获取用户发布视频列表。

字段提示

• keyword: 仅用于 search_videos，默认示例是 露营。
• url: 推荐直接粘贴微信视频号视频链接或分享文案，适用于视频详情、评论列表和用户视频列表。
• encrypted_object_id: 从 search_videos 的 Dataset 行复制，用于 get_video_detail。
• object_id / object_nonce_id: 从 get_video_detail 或评论 Dataset 行复制，用于评论和评论回复。
• comment_id: 从 get_video_comments Dataset 行复制一级评论 ID。建议选择 reply_count > 0 的评论。
• user_id: 只填以 @finder 结尾的视频号用户 ID；不要填昵称、主页名称或 @stranger ID。
• sort_type: all、time_descending、collect_count_descending。
• duration_range: all、under_5_min、between_5_and_20_min、over_20_min。
• max_items: 默认 50，最大 1000。
• auto_paginate: 默认 true。每请求一页会计为 1 次 SocialDataX API request。

示例 / Examples

视频搜索：

{
  "operation": "search_videos",
  "keyword": "露营",
  "sort_type": "all",
  "duration_range": "all",
  "page_token": "",
  "max_items": 50,
  "auto_paginate": true
}

热榜：

{
  "operation": "search_hot_list",
  "max_items": 50
}

视频详情：

{
  "operation": "get_video_detail",
  "url": "https://weixin.qq.com/sph/ANxgB9MB8i"
}

评论列表：

{
  "operation": "get_video_comments",
  "url": "https://weixin.qq.com/sph/ANxgB9MB8i",
  "page_token": "",
  "max_items": 50,
  "auto_paginate": true
}

评论回复：

{
  "operation": "get_video_comment_replies",
  "object_id": "14469096051103173201",
  "object_nonce_id": "4041472331870621547_0_39_0_0",
  "comment_id": "14608046980043114941",
  "page_token": "",
  "max_items": 50,
  "auto_paginate": true
}

用户资料：

{
  "operation": "get_user_info",
  "user_id": "v2_060000231003b20faec8c5e58110c0dcc90cee33b0777dd2f17b0e35693b274a9dd455cde24f@finder"
}

用户视频列表：

{
  "operation": "list_user_videos",
  "url": "https://weixin.qq.com/sph/ANxgB9MB8i",
  "page_token": "",
  "max_items": 50,
  "auto_paginate": true
}

输出 / Dataset

主要消费面是 Apify Dataset。列表类 operation 会把每个 item 写成一行，适合 JSON、CSV、Excel / XLSX、JSONL 导出。

行结构是扁平字段：

• operation, item_index
• query_*: 本次请求参数
• page_*: 页级分页和统计信息
• item 顶层字段，例如 object_id, description, comment_id, like_count
• author_*, video_*: 常见对象字段展开
• topic_tags, images: 数组字段保留 JSON 值

示例 Dataset row：

{
  "operation": "get_video_comments",
  "item_index": 1,
  "query_object_id": "14469096051103173201",
  "query_object_nonce_id": "4041472331870621547_0_39_0_0",
  "comment_id": "14608046980043114941",
  "content": "这个路线不错",
  "author_user_id": "v2_...@finder",
  "author_name": "示例用户",
  "reply_count": 2,
  "page_next_page_token": ""
}

OUTPUT 只保留 run summary、请求页摘要、warning 或轻量错误信息，方便调试；完整结果请从 Dataset 读取。

Apify API 调用

同步运行并直接取 Dataset items：

curl -X POST "https://api.apify.com/v2/acts/socialdatax~socialdatax-wechat-data-api/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "operation": "search_videos",
    "keyword": "露营",
    "max_items": 50,
    "auto_paginate": true
  }'

Python client：

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("socialdatax/socialdatax-wechat-data-api").call(run_input={
    "operation": "search_videos",
    "keyword": "露营",
    "max_items": 50,
    "auto_paginate": True,
})

items = list(client.dataset(run["defaultDatasetId"]).iterate_items())
print(items[:3])

计费 / Pricing

该 Actor 适合 Pay-per-event：按写入 Dataset 的 item 计费，建议事件为 apify-default-dataset-item。

Apify 免费计划用户可进行少量试用；持续使用需要 Apify paid plan。

Operator setup

Actor owner 需要在 Apify Console 中配置 secret / environment：

• SOCIALDATAX_API_KEY
• 可选：SOCIALDATAX_API_BASE_URL

Apify 用户无需填写 SocialDataX API Key。

更多信息见 SocialDataX 官网。