抖音星图 API - KOL粉丝画像 (V1)
此接口已过期
此接口已过时，可能会在未来的版本中被移除。请尽快迁移到新版本。
prod-global
GET
/api/douyin-xingtu/get-kol-fans-distribution/v1
获取粉丝画像（旧版）。
请求参数
| 参数名 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
token | query | string | 是 | 用户鉴权令牌。 |
kolId | query | string | 是 | KOL ID。 |
fansType | query | string | 否 | 粉丝类型。 可用值： - _1: 粉丝画像- _2: 粉丝群画像- _5: 铁粉画像 |
acceptCache | query | boolean | 否 | 启用缓存。 |
代码示例
💡 环境说明
默认示例使用 https://api.justoneapi.com (prod-global)。中国大陆地区建议替换为 http://47.117.133.51:30015 (prod-cn) 以获得更好的访问体验。详见 环境选择。
bash
# 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
curl -X GET "https://api.justoneapi.com/api/douyin-xingtu/get-kol-fans-distribution/v1?token=YOUR_API_KEY&kolId=VALUE"text
我想使用 Just One API 提供的“KOL粉丝画像 (V1) [已弃用]”接口。
接口地址: https://api.justoneapi.com/api/douyin-xingtu/get-kol-fans-distribution/v1
HTTP 方法: GET
身份验证: 在 URL 后添加查询参数“?token=您的API密钥”。
OpenAPI 定义: https://docs.justoneapi.com/openapi/douyin-xingtu-apis/kol-follower-profile-v1-deprecated-zh.json
请求参数说明:
- token (query): 用户鉴权令牌。 (必填)
- kolId (query): KOL ID。 (必填)
- fansType (query): 粉丝类型。
可用值：
- `_1`: 粉丝画像
- `_2`: 粉丝群画像
- `_5`: 铁粉画像
- acceptCache (query): 启用缓存。
返回格式: JSON
响应处理与错误码：
1. 需通过返回体中的 "code" 字段判断业务结果（code 为 0 表示成功）。
2. 超时建议：建议将请求超时时间设置为至少 60 秒。
3. 业务码说明：
- 0: 成功
- 100: Token 无效或已失效
- 301: 采集失败，请重试
- 302: 超出速率限制
- 303: 超出每日配额
- 400: 参数错误
- 500: 内部服务器错误
- 600: 权限不足
- 601: 余额不足
请帮我用我擅长的编程语言写一个脚本来调用这个接口，并处理返回结果。python
# 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
import requests
url = "https://api.justoneapi.com/api/douyin-xingtu/get-kol-fans-distribution/v1?token=YOUR_API_KEY&kolId=VALUE"
response = requests.get(url)
print(response.json())js
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
const response = await fetch("https://api.justoneapi.com/api/douyin-xingtu/get-kol-fans-distribution/v1?token=YOUR_API_KEY&kolId=VALUE", {
method: "GET"
});
const data = await response.json();
console.log(data);java
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.justoneapi.com/api/douyin-xingtu/get-kol-fans-distribution/v1?token=YOUR_API_KEY&kolId=VALUE"))
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}go
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
client := &http.Client{}
url := "https://api.justoneapi.com/api/douyin-xingtu/get-kol-fans-distribution/v1?token=YOUR_API_KEY&kolId=VALUE"
req, _ := http.NewRequest("GET", url, nil)
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}php
// 提示: 中国大陆地区建议将 https://api.justoneapi.com 替换为 http://47.117.133.51:30015
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.justoneapi.com/api/douyin-xingtu/get-kol-fans-distribution/v1?token=YOUR_API_KEY&kolId=VALUE");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
$response = curl_exec($ch);
curl_close($ch);
echo $response;响应结果
json
{
"code": 0,
"data": {
"base_resp": {
"status_code": 0,
"status_message": ""
},
"distributions": [
{
"description": "男性居多,占比74%",
"distribution_list": [
{
"distribution_key": "male",
"distribution_value": "31418568"
},
{
"distribution_key": "female",
"distribution_value": "10660924"
}
],
"image": [
"男性居多"
],
"origin_type": 0,
"type": 1,
"type_display": "性别分布"
},
{
"description": "分布最多的3个省份广东(12%),江苏(7%),浙江(6%)",
"distribution_list": [
{
"distribution_key": "海南",
"distribution_value": "269520"
},
{
"distribution_key": "河南",
"distribution_value": "2463373"
},
{
"distribution_key": "宁夏",
"distribution_value": "160140"
},
{
"distribution_key": "香港",
"distribution_value": "75395"
},
{
"distribution_key": "湖北",
"distribution_value": "1721824"
},
{
"distribution_key": "湖南",
"distribution_value": "1664129"
},
{
"distribution_key": "福建",
"distribution_value": "1357337"
},
{
"distribution_key": "江西",
"distribution_value": "1143643"
},
{
"distribution_key": "澳门",
"distribution_value": "16560"
},
{
"distribution_key": "内蒙古",
"distribution_value": "568038"
},
{
"distribution_key": "甘肃",
"distribution_value": "459459"
},
{
"distribution_key": "黑龙江",
"distribution_value": "651852"
},
{
"distribution_key": "重庆",
"distribution_value": "919452"
},
{
"distribution_key": "江苏",
"distribution_value": "2967497"
},
{
"distribution_key": "广西",
"distribution_value": "1051394"
},
{
"distribution_key": "北京",
"distribution_value": "827024"
},
{
"distribution_key": "台湾",
"distribution_value": "35908"
},
{
"distribution_key": "云南",
"distribution_value": "937277"
},
{
"distribution_key": "天津",
"distribution_value": "451927"
},
{
"distribution_key": "浙江",
"distribution_value": "2531368"
},
{
"distribution_key": "西藏",
"distribution_value": "45151"
},
{
"distribution_key": "陕西",
"distribution_value": "1065132"
},
{
"distribution_key": "新疆",
"distribution_value": "469390"
},
{
"distribution_key": "四川",
"distribution_value": "1993387"
},
{
"distribution_key": "青海",
"distribution_value": "89837"
},
{
"distribution_key": "河北",
"distribution_value": "1803586"
},
{
"distribution_key": "山东",
"distribution_value": "2524868"
},
{
"distribution_key": "山西",
"distribution_value": "861436"
},
{
"distribution_key": "广东",
"distribution_value": "5022865"
},
{
"distribution_key": "安徽",
"distribution_value": "1613291"
},
{
"distribution_key": "贵州",
"distribution_value": "781271"
},
{
"distribution_key": "吉林",
"distribution_value": "533097"
},
{
"distribution_key": "上海",
"distribution_value": "911265"
},
{
"distribution_key": "辽宁",
"distribution_value": "1001192"
}
],
"image": [
"广东,江苏,浙江居多"
],
"origin_type": 2,
"type": 4,
"type_display": "省份分布"
},
{
"description": "苹果手机占比25%, 消费能力较好",
"distribution_list": [
{
"distribution_key": "小米",
"distribution_value": "3126675"
},
{
"distribution_key": "iPhone",
"distribution_value": "10663765"
},
{
"distribution_key": "vivo",
"distribution_value": "4853690"
},
{
"distribution_key": "华为",
"distribution_value": "5654144"
},
{
"distribution_key": "oppo",
"distribution_value": "4107723"
},
{
"distribution_key": "红米",
"distribution_value": "2132582"
},
{
"distribution_key": "荣耀",
"distribution_value": "3363857"
},
{
"distribution_key": "其他",
"distribution_value": "8671024"
}
],
"image": [
"苹果手机较多"
],
"origin_type": 3,
"type": 8,
"type_display": "设备品牌分布"
},
{
"description": "一线居多,占比30%",
"distribution_list": [
{
"distribution_key": "一线",
"distribution_value": "11841768"
},
{
"distribution_key": "二线",
"distribution_value": "7563644"
},
{
"distribution_key": "三线",
"distribution_value": "8880668"
},
{
"distribution_key": "五线",
"distribution_value": "4138108"
},
{
"distribution_key": "四线",
"distribution_value": "6540096"
}
],
"image": [
"一线居多"
],
"origin_type": 5,
"type": 32,
"type_display": "城市等级分布"
},
{
"description": "31到40岁居多,占比30%",
"distribution_list": [
{
"distribution_key": "41-50",
"distribution_value": "3533580"
},
{
"distribution_key": "18-23",
"distribution_value": "10314969"
},
{
"distribution_key": "50+",
"distribution_value": "2034223"
},
{
"distribution_key": "31-40",
"distribution_value": "10514871"
},
{
"distribution_key": "24-30",
"distribution_value": "8535030"
}
],
"image": [
"31到40岁居多"
],
"origin_type": 1,
"type": 2,
"type_display": "年龄分布"
},
{
"description": "分布最多的1个城市广州(12%)",
"distribution_list": [
{
"distribution_key": "武汉",
"distribution_value": "682298"
},
{
"distribution_key": "东莞",
"distribution_value": "606157"
},
{
"distribution_key": "重庆",
"distribution_value": "919450"
},
{
"distribution_key": "上海",
"distribution_value": "911143"
},
{
"distribution_key": "成都",
"distribution_value": "796050"
},
{
"distribution_key": "苏州",
"distribution_value": "637191"
},
{
"distribution_key": "杭州",
"distribution_value": "627586"
},
{
"distribution_key": "广州",
"distribution_value": "986112"
},
{
"distribution_key": "深圳",
"distribution_value": "859958"
},
{
"distribution_key": "北京",
"distribution_value": "827144"
}
],
"image": [
"广州居多"
],
"origin_type": 8,
"type": 256,
"type_display": "城市分布"
},
{
"description": "分布最多的3个兴趣随拍(49%),游戏(14%),二次元(12%)",
"distribution_list": [
{
"distribution_key": "二次元",
"distribution_value": "3255252"
},
{
"distribution_key": "体育",
"distribution_value": "1472028"
},
{
"distribution_key": "社会时政",
"distribution_value": "1396900"
},
{
"distribution_key": "美食",
"distribution_value": "1050770"
},
{
"distribution_key": "随拍",
"distribution_value": "12993670"
},
{
"distribution_key": "游戏",
"distribution_value": "3754214"
},
{
"distribution_key": "亲子",
"distribution_value": "1377126"
},
{
"distribution_key": "动物",
"distribution_value": "1031695"
}
],
"image": [
"随拍,游戏,二次元居多"
],
"origin_type": 6,
"type": 64,
"type_display": "兴趣分布"
},
{
"description": "小镇青年居多,占比24%",
"distribution_list": [
{
"distribution_key": "新锐白领",
"distribution_value": "6010031"
},
{
"distribution_key": "都市蓝领",
"distribution_value": "5001909"
},
{
"distribution_key": "小镇中老年",
"distribution_value": "1326622"
},
{
"distribution_key": "精致妈妈",
"distribution_value": "688416"
},
{
"distribution_key": "Z世代",
"distribution_value": "6578576"
},
{
"distribution_key": "资深中产",
"distribution_value": "1059584"
},
{
"distribution_key": "小镇青年",
"distribution_value": "7103090"
},
{
"distribution_key": "都市银发",
"distribution_value": "995294"
}
],
"image": [
"小镇青年居多"
],
"origin_type": 10,
"type": 1024,
"type_display": "八大人群分布"
}
],
"last_update_time": "1773064800"
}
}💡 提示：为简化展示，列表类数据样例仅保留 1-2 条记录，实际返回条数以接口响应为准。