Douyin Xingtu APIs - KOL Audience Profile (V1)
DEPRECATED
This endpoint is deprecated and may be removed in future versions.
prod-global
GET
/api/douyin-xingtu/get-kol-audience-distribution/v1
Get fans audience distribution (Legacy).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
token | query | string | Yes | User authentication token. |
kolId | query | string | Yes | KOL ID. |
acceptCache | query | boolean | No | Enable cache. |
Code Samples
💡 Environment Note
Default samples use https://api.justoneapi.com (prod-global). For users in Mainland China, it is recommended to replace it with http://47.117.133.51:30015 (prod-cn) for better performance. See Environment Guide.
bash
# Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
curl -X GET "https://api.justoneapi.com/api/douyin-xingtu/get-kol-audience-distribution/v1?token=YOUR_API_KEY&kolId=VALUE"text
I want to use the "KOL Audience Profile (V1) [Deprecated]" API from Just One API.
API Endpoint: https://api.justoneapi.com/api/douyin-xingtu/get-kol-audience-distribution/v1
HTTP Method: GET
Authentication: Append "?token=YOUR_API_KEY" to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/douyin-xingtu-apis/kol-audience-profile-v1-deprecated-en.json
Parameters:
- token (query): User authentication token. (Required)
- kolId (query): KOL ID. (Required)
- acceptCache (query): Enable cache.
Return format: JSON
Response Handling & Error Codes:
1. Business results should be determined by the "code" field in the response body (code 0 means success).
2. Timeout Recommendation: Set request timeout to at least 60 seconds.
3. Business Code Reference:
- 0: Success
- 100: Invalid or Inactive Token
- 301: Collection Failed. Please Retry.
- 302: Rate Limit Exceeded
- 303: Daily Quota Exceeded
- 400: Invalid Parameters
- 500: Internal Server Error
- 600: Permission Denied
- 601: Insufficient Balance
Please help me write a script in my preferred programming language to call this API and handle the response.python
# Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
import requests
url = "https://api.justoneapi.com/api/douyin-xingtu/get-kol-audience-distribution/v1?token=YOUR_API_KEY&kolId=VALUE"
response = requests.get(url)
print(response.json())js
// Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
const response = await fetch("https://api.justoneapi.com/api/douyin-xingtu/get-kol-audience-distribution/v1?token=YOUR_API_KEY&kolId=VALUE", {
method: "GET"
});
const data = await response.json();
console.log(data);java
// Tip: For Mainland China, replace https://api.justoneapi.com with 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-audience-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
// Tip: For Mainland China, replace https://api.justoneapi.com with 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-audience-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
// Tip: For Mainland China, replace https://api.justoneapi.com with http://47.117.133.51:30015
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.justoneapi.com/api/douyin-xingtu/get-kol-audience-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;Responses
json
{
"code": 0,
"data": {
"base_resp": {
"status_code": 0,
"status_message": ""
},
"distributions": [
{
"description": "男性居多,占比79%",
"distribution_list": [
{
"distribution_key": "female",
"distribution_value": "1968283"
},
{
"distribution_key": "male",
"distribution_value": "7712817"
}
],
"image": [
"男性居多"
],
"origin_type": 0,
"type": 1,
"type_display": "性别分布"
},
{
"description": "分布最多的3个兴趣随拍(49%),二次元(13%),游戏(12%)",
"distribution_list": [
{
"distribution_key": "随拍",
"distribution_value": "3841879"
},
{
"distribution_key": "二次元",
"distribution_value": "1076709"
},
{
"distribution_key": "游戏",
"distribution_value": "955457"
},
{
"distribution_key": "社会时政",
"distribution_value": "481998"
},
{
"distribution_key": "亲子",
"distribution_value": "418445"
},
{
"distribution_key": "体育",
"distribution_value": "400978"
},
{
"distribution_key": "美食",
"distribution_value": "294718"
},
{
"distribution_key": "剧情",
"distribution_value": "281328"
}
],
"image": [
"随拍,二次元,游戏居多"
],
"origin_type": 6,
"type": 64,
"type_display": "兴趣分布"
},
{
"description": "小镇青年居多,占比27%",
"distribution_list": [
{
"distribution_key": "Z世代",
"distribution_value": "2109294"
},
{
"distribution_key": "都市银发",
"distribution_value": "441648"
},
{
"distribution_key": "资深中产",
"distribution_value": "298831"
},
{
"distribution_key": "小镇中老年",
"distribution_value": "478309"
},
{
"distribution_key": "小镇青年",
"distribution_value": "2594111"
},
{
"distribution_key": "都市蓝领",
"distribution_value": "1586769"
},
{
"distribution_key": "新锐白领",
"distribution_value": "1766809"
},
{
"distribution_key": "精致妈妈",
"distribution_value": "221550"
}
],
"image": [
"小镇青年居多"
],
"origin_type": 10,
"type": 1024,
"type_display": "八大人群分布"
},
{
"description": "分布最多的3个省份广东(13%),江苏(7%),浙江(7%)",
"distribution_list": [
{
"distribution_key": "河南",
"distribution_value": "611566"
},
{
"distribution_key": "河北",
"distribution_value": "412996"
},
{
"distribution_key": "湖南",
"distribution_value": "372769"
},
{
"distribution_key": "重庆",
"distribution_value": "200338"
},
{
"distribution_key": "宁夏",
"distribution_value": "38582"
},
{
"distribution_key": "贵州",
"distribution_value": "201955"
},
{
"distribution_key": "北京",
"distribution_value": "195647"
},
{
"distribution_key": "上海",
"distribution_value": "217988"
},
{
"distribution_key": "新疆",
"distribution_value": "126645"
},
{
"distribution_key": "湖北",
"distribution_value": "472526"
},
{
"distribution_key": "山西",
"distribution_value": "205850"
},
{
"distribution_key": "青海",
"distribution_value": "22091"
},
{
"distribution_key": "陕西",
"distribution_value": "298772"
},
{
"distribution_key": "四川",
"distribution_value": "452246"
},
{
"distribution_key": "安徽",
"distribution_value": "410511"
},
{
"distribution_key": "广西",
"distribution_value": "260548"
},
{
"distribution_key": "西藏",
"distribution_value": "20104"
},
{
"distribution_key": "香港",
"distribution_value": "11445"
},
{
"distribution_key": "内蒙古",
"distribution_value": "113857"
},
{
"distribution_key": "浙江",
"distribution_value": "712968"
},
{
"distribution_key": "澳门",
"distribution_value": "2819"
},
{
"distribution_key": "天津",
"distribution_value": "103827"
},
{
"distribution_key": "江苏",
"distribution_value": "722724"
},
{
"distribution_key": "海南",
"distribution_value": "73707"
},
{
"distribution_key": "广东",
"distribution_value": "1256860"
},
{
"distribution_key": "甘肃",
"distribution_value": "119382"
},
{
"distribution_key": "吉林",
"distribution_value": "103763"
},
{
"distribution_key": "山东",
"distribution_value": "547508"
},
{
"distribution_key": "台湾",
"distribution_value": "5801"
},
{
"distribution_key": "福建",
"distribution_value": "342116"
},
{
"distribution_key": "辽宁",
"distribution_value": "207672"
},
{
"distribution_key": "云南",
"distribution_value": "252848"
},
{
"distribution_key": "江西",
"distribution_value": "310287"
},
{
"distribution_key": "黑龙江",
"distribution_value": "123809"
}
],
"image": [
"广东,江苏,浙江居多"
],
"origin_type": 2,
"type": 4,
"type_display": "省份分布"
},
{
"description": "分布最多的1个城市广州(12%)",
"distribution_list": [
{
"distribution_key": "深圳",
"distribution_value": "221900"
},
{
"distribution_key": "杭州",
"distribution_value": "161682"
},
{
"distribution_key": "东莞",
"distribution_value": "165213"
},
{
"distribution_key": "苏州",
"distribution_value": "169547"
},
{
"distribution_key": "成都",
"distribution_value": "185635"
},
{
"distribution_key": "北京",
"distribution_value": "195647"
},
{
"distribution_key": "广州",
"distribution_value": "238932"
},
{
"distribution_key": "重庆",
"distribution_value": "200338"
},
{
"distribution_key": "上海",
"distribution_value": "217988"
},
{
"distribution_key": "武汉",
"distribution_value": "206652"
}
],
"image": [
"广州居多"
],
"origin_type": 8,
"type": 256,
"type_display": "城市分布"
},
{
"description": "苹果手机占比29%, 消费能力较好",
"distribution_list": [
{
"distribution_key": "iPhone",
"distribution_value": "2834114"
},
{
"distribution_key": "oppo",
"distribution_value": "820047"
},
{
"distribution_key": "红米",
"distribution_value": "675417"
},
{
"distribution_key": "小米",
"distribution_value": "713122"
},
{
"distribution_key": "华为",
"distribution_value": "1359329"
},
{
"distribution_key": "荣耀",
"distribution_value": "841232"
},
{
"distribution_key": "vivo",
"distribution_value": "982618"
},
{
"distribution_key": "其他",
"distribution_value": "1459977"
}
],
"image": [
"苹果手机较多"
],
"origin_type": 3,
"type": 8,
"type_display": "设备品牌分布"
},
{
"description": "一线居多,占比30%",
"distribution_list": [
{
"distribution_key": "五线",
"distribution_value": "998693"
},
{
"distribution_key": "四线",
"distribution_value": "1566423"
},
{
"distribution_key": "二线",
"distribution_value": "1897740"
},
{
"distribution_key": "三线",
"distribution_value": "2124384"
},
{
"distribution_key": "一线",
"distribution_value": "2945440"
}
],
"image": [
"一线居多"
],
"origin_type": 5,
"type": 32,
"type_display": "城市等级分布"
},
{
"description": "18到23岁居多,占比30%",
"distribution_list": [
{
"distribution_key": "50+",
"distribution_value": "552849"
},
{
"distribution_key": "41-50",
"distribution_value": "557961"
},
{
"distribution_key": "24-30",
"distribution_value": "2246253"
},
{
"distribution_key": "31-40",
"distribution_value": "2425550"
},
{
"distribution_key": "18-23",
"distribution_value": "2503346"
}
],
"image": [
"18到23岁居多"
],
"origin_type": 1,
"type": 2,
"type_display": "年龄分布"
}
],
"last_update_time": "1773064801"
}
}💡 Note: For list data, the example shows only 1-2 items for simplicity. The actual count depends on the API response.