SocialDataX API

微信 API 文档

微信公众号文章、贴图与视频号的搜索、详情、评论、统计和账号接口。各能力的输入、返回字段与计费以接口说明为准。

读取微信视频号热榜

读取微信视频号热榜，返回排名和热点标题；当前不支持翻页。

POST /socialdatax/api/v1/wechat/hot/search/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

请求示例

{}

返回字段

items（必填）：当前页结果列表。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "rank": 1,
      "keyword": "露营"
    }
  ],
  "points": {
    "cost": 10,
    "balance": 990
  }
}

搜索微信视频号视频

按关键词搜索微信视频号视频，支持排序、时长筛选和下一页分页令牌。

POST /socialdatax/api/v1/wechat/video/search

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

keyword（必填）：微信视频号视频搜索词；只传关键词或短语；不要传任何链接、encrypted_object_id、user_id 或 page_token 作为 keyword。
page_token：微信视频号视频搜索分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；只能用于同一微信视频号搜索分页链路、同一关键词和同一筛选条件，不能跨能力、关键词或筛选条件复用。
sort_type：搜索排序方式，可选：all（不限，默认）、time_descending（最新）、collect_count_descending（最热/最多收藏排序）。如无明确排序需求，保持 all。
duration_range：视频时长筛选，可选：all（不限，默认）、under_5_min（5 分钟以下）、between_5_and_20_min（5-20 分钟）、over_20_min（20 分钟以上）。如无明确筛选需求，保持 all。

请求示例

{
  "keyword": "露营",
  "page_token": "",
  "sort_type": "all",
  "duration_range": "all"
}

返回字段

items（必填）：当前页结果列表。
next_page_token（必填）：下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；next_page_token 只能用于同一微信视频号搜索分页链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "encrypted_object_id": "export/UzFfBgAAxNihABcaQCLMjMzT4DCKa25PGq4WQLbjDR5MjFnNkg",
      "content_type": "video",
      "description": "女生一人雨天户外沉浸式露营是种什么体验#户外露营 #露营 #雨中露营 #露营装备",
      "topic_tags": [
        {
          "name": "户外露营"
        },
        {
          "name": "露营"
        },
        {
          "name": "雨中露营"
        },
        {
          "name": "露营装备"
        }
      ],
      "cover_image_url": "https://example.invalid/wechat-cover.jpg",
      "publish_time": 1780931019,
      "duration_seconds": 446,
      "like_count": 87,
      "collect_count": 41,
      "comment_count": 13,
      "share_count": 47,
      "author": {
        "name": "爱玩的闷三",
        "avatar_url": "https://example.invalid/wechat-avatar.jpg"
      }
    }
  ],
  "next_page_token": "opaque-wechat-search-page-token",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

搜索微信视频号用户

按关键词或视频号ID搜索微信视频号用户，返回可用于用户资料和用户发布作品列表接口的 user_id，支持分页令牌。

POST /socialdatax/api/v1/wechat/finder/user/search

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

keyword（必填）：微信视频号用户搜索关键词，支持输入视频号ID（如 sphhTeTFNszPMPc）或昵称/关键词进行搜索；不要传链接或分页 token。
page_token：微信视频号用户搜索分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；只能用于同一微信视频号用户搜索分页链路、同一关键词，不能跨能力或关键词复用。

请求示例

{
  "keyword": "露营",
  "page_token": ""
}

返回字段

items（必填）：当前页结果列表。
next_page_token（必填）：下一页不透明分页令牌；为空表示没有更多用户搜索结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一微信视频号用户搜索分页链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "user_id": "v2_060000231003b20faec8c7e18b1dc5d7cf04e534b0777edbd7a084f0df31ae5fdc069a40607b@finder",
      "name": "露营研究所",
      "avatar_url": "https://example.invalid/wechat-user-search-avatar.jpg",
      "bio": "分享周末露营路线、营地搭建和户外装备清单，陪你把短途露营计划准备得更轻松。"
    }
  ],
  "next_page_token": "opaque-wechat-user-search-page-token",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取微信视频号作品详情

按 encrypted_object_id 或微信视频号作品链接读取公开作品详情，返回文案、媒体资源、互动指标和作者信息。

POST /socialdatax/api/v1/wechat/video/detail

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

url：微信视频号作品链接（视频或图文），或包含该链接的分享文案。
encrypted_object_id：微信视频号合法 encrypted_object_id；用户已提供时原样使用，否则可从 wechat_search_videos 或作者作品列表返回项获取。

请求体必须且只能选择一种作品详情入口：传 encrypted_object_id，或传 url。不要两个都传，也不要空请求。

请求示例

{
  "encrypted_object_id": "export/UzFfAgtgekIEAQAAAAAAd94yB38uNAAAAAstQy6ubaLX4KHWvLEZgBPEhad8ZjoqeYOLzNPgMIqpfnwabdr3lN-THd7Es0wO"
}

返回字段

object_id（必填）：微信视频号作品 object_id；获取视频评论时请与同一条视频的 object_nonce_id 一起原样传入。
object_nonce_id（必填）：微信视频号作品 object_nonce_id；获取视频评论时请与同一条视频的 object_id 一起原样传入。
content_type（必填）：内容类型。
description（必填）：string
topic_tags（必填）：作品文案中的话题标签；无话题时为空数组；每项只返回 name。
cover_image_url（必填）：统一封面图链接。
video（必填）：视频资源信息；图文内容或无视频资源时为 null。
images（必填）：图片资源列表；无图片时为空数组。
like_count（必填）：点赞数。
collect_count（必填）：收藏数。
comment_count（必填）：评论数。
share_count（必填）：分享数。
publish_time（必填）：发布时间，秒级 Unix 时间戳。
ip_location（必填）：发布时的 IP 属地；没有 IP 属地时为空字符串。
author（必填）：作者信息。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "object_id": "14469096051103173201",
  "object_nonce_id": "4041472331870621547_0_39_0_0",
  "content_type": "video",
  "description": "男人沉浸式雪中露营#雪中露营 #户外露营 #解压",
  "topic_tags": [
    {
      "name": "雪中露营"
    },
    {
      "name": "户外露营"
    },
    {
      "name": "解压"
    }
  ],
  "cover_image_url": "https://example.invalid/wechat-cover.jpg",
  "video": {
    "video_url": "https://example.invalid/wechat-video.mp4",
    "duration_ms": 264900,
    "width": 1080,
    "height": 1920
  },
  "publish_time": 1724850660,
  "collect_count": 201,
  "comment_count": 17,
  "author": {
    "user_id": "v2_060000231003b20faec8c5e38c1fc2d1ca02ed31b077443bacd942a0f8fce8dba8bb27842014@finder",
    "name": "野人日记YEREN",
    "avatar_url": "https://example.invalid/wechat-avatar.jpg",
    "bio": "野人日记 每日一更"
  },
  "like_count": 406,
  "share_count": 741,
  "ip_location": "山东",
  "images": [],
  "points": {
    "cost": 10,
    "balance": 990
  }
}

生成微信视频号作品分享链接

按微信视频号作品 object_id 生成分享链接。

POST /socialdatax/api/v1/wechat/video/share/url

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

object_id（必填）：微信视频号作品 object_id；可从作品详情或用户发布作品列表结果获取。只接受正整数 object_id，不接受 encrypted_object_id 或作品链接。

请求示例

{
  "object_id": "15011178920418020652"
}

返回字段

share_url（必填）：微信视频号作品分享链接。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "share_url": "https://example.invalid/wechat-share-url",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取微信视频号一级评论

按微信视频号视频的 object_id 与 object_nonce_id，或视频链接，读取公开一级评论列表。

POST /socialdatax/api/v1/wechat/video/comment/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

url：微信视频号视频链接，或包含该链接的分享文案。
object_id：微信视频号作品 object_id；获取视频评论时请与同一条视频的 object_nonce_id 一起原样传入。
object_nonce_id：微信视频号作品 object_nonce_id；获取视频评论时请与同一条视频的 object_id 一起原样传入。
page_token：微信视频号评论分页令牌。首次请求留空；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；只能用于同一视频评论分页链路，不能跨视频复用。

首次请求必须且只能选择一种评论入口：传 url，或同时传 object_id 与 object_nonce_id。继续翻页时只需传上一页返回的完整 next_page_token 作为 page_token；也可以继续带同一入口：同一视频链接，或同一条视频的 object_id 与 object_nonce_id。

请求示例

{
  "object_id": "14469096051103173201",
  "object_nonce_id": "4041472331870621547_0_39_0_0",
  "page_token": ""
}

返回字段

items（必填）：当前页结果列表。
next_page_token（必填）：下一页不透明分页令牌；为空表示没有更多评论。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；next_page_token 只能用于同一微信视频号评论分页链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
comment_count（必填）：评论数。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "comment_id": "14608046980043114941",
      "object_id": "14469096051103173201",
      "object_nonce_id": "4041472331870621547_0_39_0_0",
      "content": "背景音乐是什么",
      "image_urls": [],
      "stickers": [],
      "publish_time": 1741414902,
      "like_count": 0,
      "reply_count": 5,
      "ip_location": "河南",
      "author": {
        "user_id": "v5_020b0a16610401000000000016332f3df33dda000000b1afa7d8728e3dd43ef4317a780e33c292160a85dd62028f228e8916f5c34a3f69b80614e03930471c41e97150397d0ccbc3a5de5df87d7d6ec7dd6c60fde9a6b640b01c8621fb0d2189e3f77c@stranger",
        "name": "麦田星空",
        "avatar_url": "https://example.invalid/comment-avatar.jpg",
        "has_wechat_channels_account": false
      }
    }
  ],
  "next_page_token": "opaque-wechat-comment-page-token",
  "comment_count": 17,
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取微信视频号评论回复

按微信视频号视频 object_id、object_nonce_id 和一级评论 ID 读取公开评论回复列表。

POST /socialdatax/api/v1/wechat/video/comment/reply/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

object_id（必填）：微信视频号作品 object_id；获取视频评论时请与同一条视频的 object_nonce_id 一起原样传入。
object_nonce_id（必填）：微信视频号作品 object_nonce_id；获取视频评论时请与同一条视频的 object_id 一起原样传入。
comment_id（必填）：微信视频号一级评论 ID；从一级评论结果 items[].comment_id 复制，用于获取该评论下的回复；不要传回复项的 comment_id。
page_token：评论回复分页令牌；首次请求留空，继续翻页时必须将上一页返回的完整 next_page_token 原样传回；只能用于同一微信视频号、同一一级评论的回复分页链路。

请求示例

{
  "object_id": "14469096051103173201",
  "object_nonce_id": "4041472331870621547_0_39_0_0",
  "comment_id": "14608046980043114941",
  "page_token": ""
}

返回字段

items（必填）：当前页结果列表。
next_page_token（必填）：下一页不透明分页令牌；为空表示没有更多评论回复。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；next_page_token 只能用于同一微信视频号、同一一级评论的回复分页链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "comment_id": "14751566632096106621",
      "content": "liekkas拿走不谢[旺柴]",
      "image_urls": [],
      "stickers": [],
      "publish_time": 1758523777,
      "like_count": 1,
      "ip_location": "广东",
      "reply_to_comment_id": "14608046980043114941",
      "reply_to_user_id": "",
      "reply_to_user_name": "",
      "author": {
        "user_id": "v2_060000231003b20faec8c6e6891ec6d5ca06ee36b077ce9ea4fc6ccae43469044f3f50a50272@finder",
        "name": "发呆9738",
        "avatar_url": "https://example.invalid/reply-avatar.jpg",
        "has_wechat_channels_account": true
      }
    }
  ],
  "next_page_token": "",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取微信视频号用户资料

按微信视频号 user_id，或作品链接解析作者后读取公开用户资料和公开发布数量。

POST /socialdatax/api/v1/wechat/user/info

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

user_id：微信视频号用户 ID；只支持以 v2_ 开头、以 @finder 结尾的账号 ID；可从作品详情、用户发布作品列表、评论或评论回复结果中的 author.user_id 或 reply_to_user_id 复制；如果不是 v2_...@finder，不要传。
url：微信视频号作品链接（视频或图文），或包含该链接的分享文案。

请求体必须且只能选择一种用户资料入口：传 user_id，或传 url。url 支持微信视频号作品链接（视频或图文）或包含链接的分享文案，用于解析作品作者。

请求示例

{
  "user_id": "v2_060000231003b20faec8c5e58110c0dcc90cee33b0777dd2f17b0e35693b274a9dd455cde24f@finder"
}

返回字段

user_id（必填）：微信视频号用户 ID。
name（必填）：名称。
avatar_url（必填）：头像链接；没有头像时为 null。
bio（必填）：用户个人简介；没有简介时为空字符串。
gender（必填）：string
ip_location（必填）：发布时的 IP 属地；没有 IP 属地时为空字符串。
location（必填）：string
original_content_count（必填）：integer
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "user_id": "v2_060000231003b20faec8c5e58110c0dcc90cee33b0777dd2f17b0e35693b274a9dd455cde24f@finder",
  "name": "汽配老板大橙子",
  "avatar_url": "https://example.invalid/wechat-avatar.jpg",
  "bio": "汽配老板与00后员工斗智斗勇的日常",
  "gender": "male",
  "ip_location": "上海",
  "location": "浙江 杭州",
  "original_content_count": 5,
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取微信视频号用户发布作品列表

按微信视频号 user_id 或作品链接解析作者后读取已发布作品列表（含视频和图文），支持分页令牌。

POST /socialdatax/api/v1/wechat/user/video/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

user_id：微信视频号用户 ID；只支持以 v2_ 开头、以 @finder 结尾的账号 ID；可从作品详情、用户发布作品列表、评论或评论回复结果中的 author.user_id 或 reply_to_user_id 复制；如果不是 v2_...@finder，不要传。
url：微信视频号作品链接（视频或图文），或包含该链接的分享文案。
page_token：微信视频号用户发布作品列表分页令牌；首次请求留空，继续翻页时必须将上一次返回的完整 next_page_token 原样传入，作为 page_token 使用；只能用于同一微信视频号用户发布作品分页链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。

首次请求必须且只能选择一种用户发布列表入口：传 user_id，或传 url。继续翻页时只需传上一页返回的完整 next_page_token 作为 page_token；也可以继续带同一入口：同一微信视频号用户 ID，或同一作品链接。

请求示例

{
  "user_id": "v2_060000231003b20faec8c7e4891fc4ddcf0dee34b077dec72328afb683c547d385d93d3a71bb@finder",
  "page_token": ""
}

返回字段

items（必填）：当前页结果列表。
next_page_token（必填）：下一页不透明分页令牌；为空表示没有更多用户发布作品。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一微信视频号用户发布作品分页链路；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "object_id": "14882122090270235141",
      "object_nonce_id": "12801331239707625908_0_39_2_40_1779790168930270_fb716eb6-58ea-11f1-99a5-7f6b04ec7b34",
      "encrypted_object_id": "export/UzFfBgAAxNGHRAoDCiCmjczT4DCJo_ucN9zrVAowGRSwVwd2ng",
      "content_type": "video",
      "description": "",
      "topic_tags": [],
      "cover_image_url": "https://example.invalid/wechat-user-video-cover.jpg",
      "video": {
        "video_url": "https://example.invalid/wechat-user-video.mp4",
        "duration_ms": 14400,
        "width": 1080,
        "height": 1920
      },
      "images": [],
      "publish_time": 1781423978,
      "collect_count": 4,
      "comment_count": 0,
      "author": {
        "user_id": "v2_060000231003b20faec8c7e4891fc4ddcf0dee34b077dec72328afb683c547d385d93d3a71bb@finder",
        "name": "美丽的梦8628",
        "avatar_url": "https://example.invalid/wechat-user-avatar.jpg"
      }
    }
  ],
  "next_page_token": "opaque-wechat-user-video-page-token",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

搜索微信公众号贴图

按关键词查找公众号贴图，支持综合、最新、最热排序与分页。翻页时保持关键词和排序不变。

POST /socialdatax/api/v1/wechat/mp/image_post/search

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

keyword（必填）：公众号贴图搜索词或关键词短语；例如量子位、人工智能。不要传贴图链接或公众号账号 ID。
page_token：贴图搜索分页令牌；首次留空，继续翻页原样传回 next_page_token，并保持 keyword 和 sort_type 不变。请在 3 天内续页；令牌失效后需重新搜索。
sort_type：排序方式：general（综合，默认）、time_descending（最新发布）、hot（最热，顺序以平台结果为准）。

请求示例

{
  "keyword": "量子位",
  "sort_type": "time_descending",
  "page_token": ""
}

返回字段

items（必填）：本页公众号贴图搜索结果。
next_page_token（必填）：下一页分页令牌；空字符串表示已结束，应停止翻页；非空时完整原样传回 page_token，并保持 keyword 和 sort_type 不变。请在 3 天内续页；令牌失效后需重新搜索。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "title": "人工智能行业动态",
      "summary": "",
      "account_name": "量子位",
      "read_count_text": null,
      "cover_image_url": "https://example.invalid/wechat-mp-cover.jpg",
      "article_url": "https://mp.weixin.qq.com/s/cyog0u9QpLFvdBsh9JR3_g",
      "publish_time": 1790115069
    }
  ],
  "next_page_token": "",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取微信公众号账号贴图

按公众号账号 ID 读取该账号发布的贴图列表，支持分页。账号 ID 可从公众号文章详情的 account.account_id 复用。publish_time 为作品发布时间（Unix 秒），缺失时返回 null；翻页原样传回 next_page_token。

POST /socialdatax/api/v1/wechat/mp/account/image_post/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

account_id（必填）：公众号账号 ID；可从公众号文章详情返回的 account.account_id 获取。
page_token：公众号账号贴图分页令牌；首次请求留空，继续翻页时原样传回上一页返回的 next_page_token。

请求示例

{
  "account_id": "gh_114e76fd6e5d",
  "page_token": ""
}

返回字段

account_id（必填）：公众号账号 ID。
items（必填）：当前页公众号贴图。
next_page_token（必填）：下一页分页令牌；为空表示没有更多贴图。继续翻页时原样传回。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "account_id": "gh_114e76fd6e5d",
  "items": [
    {
      "title": "公众号贴图标题",
      "summary": "",
      "cover_image_url": "https://example.invalid/wechat-mp-cover.jpg",
      "article_url": "https://mp.weixin.qq.com/s/cyog0u9QpLFvdBsh9JR3_g",
      "publish_time": 1780572706,
      "is_paid": false
    }
  ],
  "next_page_token": "",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

搜索微信公众号文章

按搜索词查找公众号文章，支持排序、发布时间筛选和分页。翻页时保持搜索词及筛选条件不变。结果中的 summary 是摘要片段；读取全文时，将 article_url 作为 url 传给文章详情接口。查询指定公众号发布的文章请使用账号文章列表接口。

POST /socialdatax/api/v1/wechat/mp/article/search

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

keyword（必填）：公众号文章搜索词或关键词短语；例如量子位、人工智能。不要传文章链接或公众号账号 ID。
page_token：文章搜索分页令牌；首次留空，继续翻页原样传回 next_page_token，并保持 keyword、sort_type 和 publish_time_range 不变。请在 3 天内续页；令牌失效后需重新搜索。
sort_type：排序方式：general（综合/相关性，默认）、time_descending（最新发布）、hot（最热，顺序以平台结果为准）。
publish_time_range：发布时间范围：all（不限，默认）、day（最近一天）、week（最近七天）、half_year（最近半年）。

请求示例

{
  "keyword": "量子位",
  "sort_type": "time_descending",
  "publish_time_range": "week",
  "page_token": ""
}

返回字段

items（必填）：本页公众号文章搜索结果。
next_page_token（必填）：下一页分页令牌；空字符串表示已结束，应停止翻页；非空时完整原样传回 page_token，并保持 keyword、sort_type 和 publish_time_range 不变。请在 3 天内续页；令牌失效后需重新搜索。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "title": "人工智能行业动态",
      "summary": "文章摘要",
      "account_name": "量子位",
      "read_count_text": "阅读 8万+",
      "cover_image_url": "https://example.invalid/wechat-mp-cover.jpg",
      "article_url": "https://mp.weixin.qq.com/s/cyog0u9QpLFvdBsh9JR3_g",
      "publish_time": 1790115069
    }
  ],
  "next_page_token": "",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取微信公众号文章详情

按微信公众号文章链接或包含链接的分享文案读取文章详情和正文。转载卡片页返回当前公众号的推荐语及原文卡片，linked_articles 提供原文入口；不会自动读取原文全文。

POST /socialdatax/api/v1/wechat/mp/article/detail

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

url（必填）：微信公众号文章链接，或包含文章链接的分享文案。

请求示例

{
  "url": "https://mp.weixin.qq.com/s/cyog0u9QpLFvdBsh9JR3_g"
}

返回字段

biz（必填）：string
mid（必填）：string
idx（必填）：string
sn（必填）：string
title（必填）：公众号文章标题。
account（必填）：见 Schema
publish_time（必填）：发布时间，秒级 Unix 时间戳。
cover_image_url（必填）：统一封面图链接。
description（必填）：公众号文章摘要。
article_url（必填）：规范化后的公众号文章链接。
content_text（必填）：正文纯文本。
content_html（必填）：正文 HTML 片段。
image_urls（必填）：正文图片链接，按页面顺序返回。
linked_articles（必填）：正文内链公众号文章列表。
finder_video_cards（必填）：正文内嵌视频号卡片列表。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "biz": "MzA4NjQyNjQyNA==",
  "mid": "2247485000",
  "idx": "1",
  "sn": "article-sn",
  "title": "公众号文章标题",
  "account": {
    "name": "浙江之声",
    "account_id": "zhejiangzhisheng",
    "avatar_url": "https://example.invalid/wechat-mp-avatar.jpg",
    "signature": "公众号简介"
  },
  "publish_time": 1780572706,
  "cover_image_url": "https://example.invalid/wechat-mp-cover.jpg",
  "description": "文章摘要",
  "article_url": "https://mp.weixin.qq.com/s/cyog0u9QpLFvdBsh9JR3_g",
  "content_text": "文章正文纯文本",
  "content_html": "<p>文章正文</p>",
  "image_urls": [
    "https://example.invalid/wechat-mp-image.jpg"
  ],
  "linked_articles": [],
  "finder_video_cards": [],
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取微信公众号账号资料

按公众号账号 ID 读取账号名称、IP 属地、原创文章数和关联视频号。账号 ID 可从公众号文章详情的 account.account_id 复用。

POST /socialdatax/api/v1/wechat/mp/account/info

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

account_id（必填）：公众号账号 ID；可从公众号文章详情返回的 account.account_id 获取。

请求示例

{
  "account_id": "gh_114e76fd6e5d"
}

返回字段

account_id（必填）：公众号账号 ID。
name（必填）：公众号名称；不可用时为空字符串。
ip_location（必填）：公众号 IP 属地；不可用时为空字符串。
original_article_count（必填）：公众号原创文章数；当前不可用时为 null。
linked_video_account（必填）：关联视频号；当前未关联或不可用时为 null。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "account_id": "gh_114e76fd6e5d",
  "name": "量子位",
  "ip_location": "北京 海淀",
  "original_article_count": 4079,
  "linked_video_account": {
    "name": "量子位",
    "user_id": "v2_060000231003b20faec8c7ea8e10c0d0cc02e535b0777911f2a26aa13518c7c2032ad76804d2@finder"
  },
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取微信公众号账号文章

按公众号账号 ID 读取该账号发布的文章列表，支持分页。账号 ID 可从公众号文章详情的 account.account_id 复用。publish_time 为作品发布时间（Unix 秒），缺失时返回 null；翻页原样传回 next_page_token。

POST /socialdatax/api/v1/wechat/mp/account/article/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

account_id（必填）：公众号账号 ID；可从公众号文章详情返回的 account.account_id 获取。
page_token：公众号账号文章分页令牌；首次请求留空，继续翻页时原样传回上一页返回的 next_page_token。

请求示例

{
  "account_id": "gh_114e76fd6e5d",
  "page_token": ""
}

返回字段

account_id（必填）：公众号账号 ID。
items（必填）：当前页公众号文章。
next_page_token（必填）：下一页分页令牌；为空表示没有更多文章。继续翻页时原样传回。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "account_id": "gh_114e76fd6e5d",
  "items": [
    {
      "title": "公众号文章标题",
      "summary": "文章摘要",
      "cover_image_url": "https://example.invalid/wechat-mp-cover.jpg",
      "article_url": "https://mp.weixin.qq.com/s/cyog0u9QpLFvdBsh9JR3_g",
      "publish_time": 1780572706,
      "is_paid": false
    }
  ],
  "next_page_token": "",
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取微信公众号文章统计

按微信公众号文章链接或包含链接的分享文案读取阅读、点赞、推荐（爱心，原在看）、分享、收藏和评论统计。

POST /socialdatax/api/v1/wechat/mp/article/stats

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

url（必填）：微信公众号文章链接，或包含文章链接的分享文案。

请求示例

{
  "url": "https://mp.weixin.qq.com/s/cyog0u9QpLFvdBsh9JR3_g"
}

返回字段

article_url（必填）：规范化后的公众号文章链接。
read_count（必填）：文章阅读数；当前不可用时为 null。
like_count（必填）：文章点赞数；当前不可用时为 null。
share_count（必填）：文章分享数；当前不可用时为 null。
collect_count（必填）：文章收藏数；当前不可用时为 null。
comment_count（必填）：文章评论数；当前不可用时为 null。
recommend_count：文章推荐数（爱心，原在看）；与点赞数不同，当前不可用时为 null。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "article_url": "https://mp.weixin.qq.com/s/cyog0u9QpLFvdBsh9JR3_g",
  "read_count": 28516,
  "like_count": 22,
  "recommend_count": 7,
  "share_count": 978,
  "collect_count": 34,
  "comment_count": 28,
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取微信公众号文章评论

按微信公众号文章链接或包含链接的分享文案读取可见一级评论，支持使用下一页令牌继续翻页。文章留言总数可能包含回复，不等于一级评论条数。请在 3 天内继续翻页，令牌失效时从首页重新获取。

POST /socialdatax/api/v1/wechat/mp/article/comment/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

url（必填）：微信公众号文章链接，或包含文章链接的分享文案。
page_token：评论分页令牌；首次请求留空。

请求示例

{
  "url": "https://mp.weixin.qq.com/s/cyog0u9QpLFvdBsh9JR3_g",
  "page_token": ""
}

返回字段

items（必填）：当前页公众号文章评论。
next_page_token（必填）：公众号文章评论分页令牌；空字符串表示已结束，应停止翻页；非空时将完整令牌原样传回 page_token，并保持文章链接不变；请在 3 天内继续翻页，令牌失效时从首页重新获取。
comment_count（必填）：文章留言总数，可能包含回复，不等于一级评论条数。
featured_count（必填）：精选一级评论总数。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "comment_id": "6255846262940111556",
      "content": "文章评论内容",
      "author": {
        "name": "用户昵称"
      },
      "publish_time": 1741148719,
      "like_count": 87,
      "reply_count": 0,
      "ip_location": "浙江",
      "is_featured": true
    }
  ],
  "next_page_token": "opaque-wechat-mp-comment-page-token",
  "comment_count": 28,
  "featured_count": 22,
  "points": {
    "cost": 10,
    "balance": 990
  }
}

读取微信公众号文章评论回复

按微信公众号文章链接（或包含链接的分享文案）读取评论回复；可传一级评论 ID 指定评论，留空时自动选择有回复的评论。支持使用下一页令牌继续翻页；同一分页链路保持文章和父评论不变，请在 3 天内继续翻页，令牌失效时从首页重新获取。

POST /socialdatax/api/v1/wechat/mp/article/comment/reply/list

1 积分 = 0.01 元；成功调用扣减 10 积分，失败不扣费。

请求参数

url（必填）：微信公众号文章链接，或包含文章链接的分享文案。
comment_id：一级评论 ID；从评论列表结果复制；可留空，由服务自动选择有回复的评论。
page_token：评论回复分页令牌；首次请求留空。

请求示例

{
  "url": "https://mp.weixin.qq.com/s/cyog0u9QpLFvdBsh9JR3_g",
  "comment_id": "6255846262940111556",
  "page_token": ""
}

返回字段

items（必填）：当前页公众号文章评论回复。
next_page_token（必填）：公众号文章评论回复分页令牌；继续翻页时原样传回；只能用于同一篇文章下同一条一级评论的回复分页链路；请在 3 天内继续翻页，令牌失效时从首页重新获取。
reply_count（必填）：该一级评论的回复总数。
points（必填）：本次成功调用的积分消耗与调用完成时的账户积分余额。

响应示例（仅说明结构）

{
  "items": [
    {
      "comment_id": "6255846262940111557",
      "parent_comment_id": "6255846262940111556",
      "content": "文章评论回复内容",
      "author": {
        "name": "晴天"
      },
      "publish_time": 1741148720,
      "ip_location": "浙江",
      "is_ai_generated": false,
      "is_featured": false
    }
  ],
  "next_page_token": "",
  "reply_count": 1,
  "points": {
    "cost": 10,
    "balance": 990
  }
}

鉴权与在线测试

业务 API 使用 API Key 鉴权。公开文档无需登录；在线测试可手动输入 API Key，登录后也可选择账户已有 Key。手动输入的 Key 仅在当前页面使用，curl 示例始终引用 SOCIALDATAX_API_KEY 环境变量。

机器可读入口

开发工具和 AI 可以通过以下公共入口读取最新文档，接口数据由后端统一生成。