获取关注列表

获取当前视频号的关注用户列表，支持通过 lastBuff 分页加载。

接口地址： POST /finder/getFollowList

前置条件

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

请求参数

参数名	必选	类型	说明
wId	是	string	登录实例标识
lastBuff	否	string	分页参数；首次传空，翻页时传响应中的 lastBuffer
myUserName	是	string	自己的视频号用户编码
myRoleType	是	int	自己的视频号角色类型

请求示例

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

响应参数

参数名	类型	说明
code	string	1000 成功，1001 失败
message	string	反馈信息
data	object	关注列表结果
data.contactList	array	关注用户列表
data.contactList[].username	string	视频号用户编码
data.contactList[].nickname	string	昵称
data.contactList[].headUrl	string	头像地址
data.contactList[].signature	string	简介
data.contactList[].authInfo	object	认证信息
data.contactList[].extInfo	object	地区、性别等扩展信息
data.contactList[].followTime	number	关注时间，Unix 秒级时间戳
data.contactList[].followFlag	int	关注状态
data.contactList[].liveStatus	int	直播状态
data.lastBuffer	string	下一页分页参数
data.followCount	number	关注数量
data.continueFlag	int	是否还有下一页：1 有，0 无

成功响应

{
  "code": "1000",
  "message": "获取关注列表成功",
  "data": {
    "contactList": [
      {
        "signature": "。。。",
        "headUrl": "https://wx.qlogo.cn/finderhead/ver_1/example/0",
        "authInfo": {},
        "extInfo": {
          "country": "CN",
          "province": "",
          "city": "",
          "sex": 2
        },
        "followTime": 1718847606,
        "nickname": "朝vvvv",
        "followFlag": 1,
        "liveStatus": 2,
        "username": "v2_060000231003b20faec8c6e18f10c7d6c903ec776955d3d97c6b329d6aa58693bcdb7ad1@finder",
        "status": 0
      }
    ],
    "lastBuffer": "CL+fAxu8+qqBg==",
    "followCount": 1,
    "continueFlag": 1
  }
}

错误响应

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

使用建议

• 继续翻页时，请把响应中的 lastBuffer 原样传给下一次请求的 lastBuff。
• continueFlag=0 表示没有下一页。
• 关注列表字段较多，业务侧可优先使用 username、nickname、headUrl、followTime。