获取粉丝列表

我的收藏

Scope: fans.list 需要申请权限需要用户授权该接口获取用户最近的粉丝列表。

接口说明

使用限制

•

接口返回粉丝列表不保证顺序性。

•

接口支持查询粉丝数的上限为 5,000。

注意事项

•

本接口获取的粉丝数据为抖音的粉丝，存在与抖音端上数据展示不一致的可能（抖音客户端展示粉丝数还包括头条和西瓜粉丝数）。

请求地址

HTTP URL	https://open.douyin.com/fans/list/
HTTP Method	GET

请求头

名称	类型	必填	描述
Content-Type	string	是	固定值 "application/json"
access-token	string	是	调用`/oauth/client_token/`生成，需要用户授权。示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1******

请求参数

URL 请求

参数名称	参数类型	是否必填	参数描述	参数示例
open_id	string	true	通过 `/oauth/access_token/` 获取，用户唯一标志。	ba253642-0590-40bc-9bdf-9a1334b94059
cursor	i64	false	分页游标, 第一页请求 cursor 是 0，response 中会返回下一页请求用到的 cursor, 同时 response 还会返回 has_more 来表明是否有更多的数据。	0
count	i32	true	每页数量	10

请求示例

响应参数

响应示例

正常示例

{
  "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"
  }
}

错误码

进入状态码排查工具查询。

错误码	描述	排查建议
2100005	"参数不合法"	检查入参合法性
419	“count 参数大于 20”	count 参数小于等于 20
500	“系统繁忙，此时请开发者稍候再试”	请重试
437	“当前用户为私密状态”	私密用户或粉丝、关注不可见的视频被过滤