实时用户主页

实时获取指定视频号用户的主页信息和作品列表，适合需要最新作品数据的场景，支持通过 pageCode 翻页。

接口地址： POST /finderLiveUserHome

前置条件

• 当前 wId 已完成登录，并且账号状态正常。
• userName 为目标视频号用户编码，通常来自搜索接口、关注列表或视频详情返回。
• meUserName 为当前账号自己的视频号用户编码，可从个人主页接口获取。
• 首次请求 pageCode 传空字符串；继续翻页时传上一次响应返回的 pageCode。

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
userName	是	string	目标视频号用户编码
meUserName	是	string	自己的视频号用户编码
pageCode	否	string	分页参数；首次传空，翻页时传响应中的 pageCode

请求示例

{
  "wId": "{{wId}}",
  "userName": "v2_060000231003b20faec8c7e48d19c0d4c90ce533b0772e1c08f4c6e0ce38be3ca98f63f23589@finder",
  "meUserName": "v2_060000231003b20fae8f10c7d6c903ec3db0776955d3d97c6b329d6aa58693bcdb7ad1@finder",
  "pageCode": ""
}

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object	实时主页信息
data.videoList	array	作品列表
data.videoList[].id	number	作品 ID
data.videoList[].nickName	string	作者昵称
data.videoList[].userName	string	作者视频号用户编码
data.videoList[].createTime	number	发布时间，Unix 秒级时间戳
data.videoList[].forwardCount	number	转发数
data.videoList[].likeCount	number	点赞数
data.videoList[].commentCount	number	评论数
data.videoList[].friendLikeCount	number	好友点赞数
data.videoList[].objectNonceId	string	作品 nonce 标识
data.videoList[].sessionBuffer	string	上下文会话数据
data.videoList[].favCount	number	收藏数
data.videoList[].urlValidTime	number	媒体链接有效时长，单位秒
data.videoList[].finderUser	object	作者信息
data.videoList[].videoDetails	object	作品内容详情
data.videoList[].videoDetails.mediaList	array	媒体列表
data.videoList[].commentList	array	评论列表，可能为 null
data.pageCode	string	下一页分页参数；为空表示没有下一页

成功响应

{
  "code": "1000",
  "message": "处理成功",
  "data": {
    "videoList": [
      {
        "id": 13896873690464655572,
        "nickName": "澎湃新闻",
        "userName": "v2_060000231003b20faec8c7e48d19c0d4c90ce533b0772e1c08f4c6e0ce38be3ca98f63f23589@finder",
        "createTime": 1656636439,
        "forwardCount": 0,
        "likeCount": 0,
        "commentCount": 0,
        "friendLikeCount": 0,
        "objectNonceId": "17352144057849403142_0_0_0_1",
        "sessionBuffer": "eyJzZXNzaW9uX2lkIjoi...",
        "favCount": 0,
        "urlValidTime": 172800,
        "finderUser": {
          "userName": "v2_060000231003b20faec8c7e48d19c0d4c90ce533b0772e1c08f4c6e0ce38be3ca98f63f23589@finder",
          "nickName": "澎湃新闻",
          "headUrl": "http://wx.qlogo.cn/finderhead/ver_1/example/0",
          "signature": "",
          "authInfo": {
            "authIconType": 2,
            "authProfession": "上海东方报业有限公司",
            "detailLink": "pages/index/index.html?showdetail=true&username=v2_060000231003b20faec8c7e48d19c0d4c90ce533b0772e1c08f4c6e0ce38be3ca98f63f23589@finder",
            "appName": "gh_4ee148a6ecaa@app"
          }
        },
        "videoDetails": {
          "desc": "庆祝香港回归祖国25周年大会暨香港特别行政区第六届政府就职典礼",
          "mediaType": 9,
          "mediaList": [
            {
              "url": "http://wxapp.tc.qq.com/251/20304/stodownload?...",
              "thumbUrl": "http://wxapp.tc.qq.com/251/20304/stodownload?...",
              "mediaType": 9,
              "videoPlayLen": 0,
              "width": 631,
              "height": 1123,
              "md5": "",
              "fileSize": 392867
            }
          ],
          "location": {
            "longitude": "121.43687",
            "latitude": "31.18826",
            "city": "上海市"
          },
          "finderTopicInfo": null,
          "commentList": null
        },
        "commentList": null
      }
    ],
    "pageCode": "CPuwyLui0oe5wAEQAQ=="
  }
}

错误响应

{
  "code": "1001",
  "message": "失败",
  "data": null
}

使用建议

• 需要更接近实时的用户主页数据时使用本接口；普通主页浏览可优先使用获取用户主页接口。
• 翻页时必须使用上一次响应中的 pageCode，不要自行拼接。
• 媒体链接有有效期，下载、转存或二次处理应尽快完成。