抖音开放平台Logo
开发者文档
控制台

获取用户粉丝喜好

收藏
我的收藏

接口说明

该接口用于获取用户粉丝来源。​

  • Scope: data.external.fans_favourite


注意:

  • 数据产出限制
    • 数据产出时间为 t+1
    • 要求主播粉丝数 > 10000
    • 要求粉丝至少有 1 个活跃
    • 要求作品完播次数 > 0

基本信息

名称描述
HTTP URL
https://open.douyin.com/data/extern/fans/favourite/
HTTP Method
GET
Scope
data.external.fans_favourite
权限要求
  • 需要申请权限。路径:抖音开放平台控制台 > 应用详情 > 能力管理 > 数据权限​

请求参数

请求头
access-token必填String
示例:act.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
示例:application/json
固定值"application/json"
Query
open_id必填String
示例:ba253642-0590-40bc-9bdf-9a1334b94059

用户唯一标志,通过 /oauth/access_token 返回的 open_id 字段获取

请求示例
curl --location --request GET '/data/extern/fans/favourite/?open_id=ba253642-0590-40bc-9bdf-9a1334b94059' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data ''

响应参数

Body展开全部子属性
dataStruct
展开子属性
extraStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "error_code": 0, "description": "", "list": [ { "rank": 1, "keyword": "关键词测试", "hot_value": 10000 } ] }, "extra": { "sub_description": "", "logid": "202008121419360101980821035705926A", "now": 1597213176393, "error_code": 0, "description": "", "sub_error_code": 0 } }

错误码

HTTP 状态码错误码错误码描述排查建议
20028001005
系统内部错误,请重试
请求重试,若依然无解请向平台提交反馈
20028001003
access_token无效
重新请求生成access_token
20028001008
access_token过期,请刷新或重新授权
重新请求生成access_token
20028001016
当前应用已被封禁或下线
clientKey被封禁或者下线
20028001006
网络调用错误,请重试
重试即可
20028001014
应用未授权任何能力
确认应用是否授权能力
20028001018
应用未获得该能力
开通相关能力
20028003017
quota已用完
联系平台处理
20028001019
应用该能力已被封禁
该能力被封禁,联系平台处理
20028001007
参数不合法
根据错误信息检查请求参数是否填写正常