Skip to content

获取赞和收藏的视频列表

获取当前视频号已红心、点赞或收藏的视频列表,支持按类型筛选和分页。

接口地址: POST /finder/getLikeAndFavList

前置条件

  • 当前 wId 已完成登录,并且账号状态正常。
  • myUserNamemyRoleType 建议从个人主页接口返回值中读取。
  • 首次请求 lastBuff 传空字符串;继续翻页时传上一次响应返回的 lastBuffer

请求参数

参数名必选类型说明
wIdstring登录实例标识
lastBuffstring分页参数;首次传空,翻页时传响应中的 lastBuffer
myUserNamestring自己的视频号用户编码
myRoleTypeint自己的视频号角色类型
flagint视频类型:7 全部,1 红心,2 大拇指,4 收藏

请求示例

json
{
  "wId": "{{wId}}",
  "lastBuff": "",
  "myUserName": "v2_060000231003b20faec8cae18cb07ea33b077ba915250774edbea38082ea6b24af229@finder",
  "myRoleType": 3,
  "flag": 7
}

响应参数

参数名类型说明
codestring1000 成功,1001 失败
messagestring反馈信息
dataobject列表结果
data.contactListarray视频号用户或内容列表,按接口实际返回为准
data.contactList[].usernamestring视频号用户编码
data.contactList[].nicknamestring昵称
data.contactList[].headUrlstring头像地址
data.contactList[].signaturestring简介
data.contactList[].authInfoobject认证信息
data.contactList[].extInfoobject地区、性别等扩展信息
data.contactList[].followTimenumber相关时间,Unix 秒级时间戳
data.contactList[].followFlagint关注状态
data.contactList[].liveStatusint直播状态
data.lastBufferstring下一页分页参数
data.followCountnumber当前返回数量或相关计数
data.continueFlagint是否还有下一页:1 有,0

成功响应

json
{
  "code": "1000",
  "message": "获取赞和收藏列表成功",
  "data": {
    "contactList": [
      {
        "signature": "",
        "headUrl": "https://wx.qlogo.cn/finderhead/ver_1/example/0",
        "authInfo": {},
        "extInfo": {
          "country": "CN",
          "province": "Jiangsu",
          "city": "Nanjing",
          "sex": 1
        },
        "followTime": 1718847509,
        "nickname": "阿星5679",
        "followFlag": 1,
        "liveStatus": 2,
        "username": "v2_060000231003b20faec8c7ea8f1ecbd1c901ef3cb0773696efb506324185fdd53ba44426a8a7@finder",
        "status": 0
      }
    ],
    "lastBuffer": "CK23AhAA",
    "followCount": 2,
    "continueFlag": 0
  }
}

错误响应

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

使用建议

  • 使用 flag 做列表筛选,避免一次拉取后在业务侧二次筛选。
  • 继续翻页时,请把响应中的 lastBuffer 原样传给下一次请求的 lastBuff
  • continueFlag=0 表示没有下一页。