抖音开放平台Logo
控制台

获取用户粉丝数据

更新时间 2024-07-24 02:58:49
收藏
我的收藏

接口说明

该接口用于查询用户的粉丝数据，如性别分布，年龄分布，地域分布等。​

  • Scope: fans.data.bind​


注意：

  • 用户首次授权应用后，需要间隔 2 天才会产生全部的数据；
  • 并只提供粉丝大于 100 的用户数据。
  • 粉丝来源包含抖音、抖音极速版和火山应用

基本信息

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

请求头

名称字段类型是否必填示例描述
access-tokenString是act.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
调用https://open.douyin.com/oauth/access_token/生成的token
content-typeString是application/json
固定值"application/json"

请求参数

Query

名称字段类型是否必填示例描述
open_idString是ba253642-0590-40bc-9bdf-9a1334b94059
通过/oauth/access_token/获取，用户唯一标志

请求示例

curl --location --request GET 'https://open.douyin.com/api/douyin/v1/user/fans_data/?open_id=ba253642-0590-40bc-9bdf-9a1334b94059' \
--header 'content-type: application/json' \
--header 'access-token: 0801121846735352506a356a6' \
--data ''

响应参数

Body

名称字段类型是否必填示例描述

响应示例

正常响应示例

{
  "data": {
    "description": "",
    "error_code": "0",
    "fans_data": {
      "active_days_distributions": [
        {
          "item": "5~8",
          "value": 0
        }
      ],
      "age_distributions": [
        {
          "item": "1-23",
          "value": 0
        }
      ],
      "all_fans_num": 0,
      "device_distributions": [
        {
          "item": "华为",
          "value": 0
        }
      ],
      "flow_contributions": [
        {
          "all_sum": "vv",
          "fans_sum": 0,
          "flow": 0
        }
      ],
      "gender_distributions": [
        {
          "item": "1",
          "value": 0
        }
      ],
      "geographical_distributions": [
        {
          "item": "北京",
          "value": 0
        }
      ],
      "interest_distributions": [
        {
          "item": "美食",
          "value": 0
        }
      ]
    }
  },
  "extra": {
    "description": "",
    "error_code": "0",
    "logid": "202008121419360101980821035705926A",
    "now": "1597213176393",
    "sub_description": "",
    "sub_error_code": "0"
  }
}

异常响应示例

{
  "data": {
    "description": "Parameter error",
    "error_code": 2100005
  },
  "extra": {
    "logid": "2020070614111601022506808001045D59",
    "now": 1594015876138
  }
}

错误码

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