获取粉丝列表

Scope: fans.list 需要用户授权 获取用户最近的粉丝列表，不保证顺序；目前可查询的粉丝数上限 5 千。该接口适用于抖音。

注意：

  • 抖音的 OAuth API 以https://open.douyin.com/开头。
  • 本接口获取的粉丝数据为抖音的粉丝，抖音客户端展示的还包括头条和西瓜的粉丝数，与抖音端上数据可能不一致。

状态码排查

进入【状态码排查工具】

请求地址

GET /fans/list/

请求头

  • Content-Type: application/json
  • access-token: 调用/oauth/access_token/生成的 token，此 token 需要用户授权。示例: act.1d1021d2aee3d41fee2d2add43456badMFZnrhFhfWotu3Ecuiuka27L56lr

请求参数

URL 请求

参数名称参数类型参数描述参数示例是否必填
暂无数据

请求样例

响应参数

参数名称参数类型参数描述参数示例是否必填
暂无数据

响应样例

{
  "data": {
    "list": [
      {
        "open_id": "0da22181-d833-447f-995f-1beefea5bef3",
        "union_id": "1ad4e099-4a0c-47d1-a410-bffb4f2f64a4",
        "nickname": "张伟",
        "avatar": "https://example.com/x.jpeg",
        "city": "上海",
        "province": "上海",
        "country": "中国",
        "gender": 0
      }
    ],
    "total": 100,
    "cursor": 0,
    "error_code": 0,
    "description": "",
    "has_more": false
  },
  "extra": {
    "sub_description": "",
    "logid": "202008121419360101980821035705926A",
    "now": 1597213176393,
    "error_code": 0,
    "description": "",
    "sub_error_code": 0
  }
}

响应错误样例

{
  "data": {
    "error_code": 2100005,
    "description": "Parameter error"
  },
  "extra": {
    "error_code": 2100005,
    "description": "Parameter error",
    "sub_error_code": 0,
    "sub_description": "",
    "now": 1594015876138,
    "log_id": "2020070614111601022506808001045D59"
  }
}
诚邀您对本文档易读易用性进行评价
好用
不好用