Douyin Xingtu APIs - Author Fans Distribution (V1)
prod-global
GET
/api/douyin-xingtu/gw/api/data_sp/get_author_fans_distribution/v1
Get author's fans demographics and distribution.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
token | query | string | Yes | User authentication token. |
oAuthorId | query | string | Yes | Author's unique ID. |
authorType | query | string | No | Author type filter. Available Values: - FAN: Fan- DIE_HARD_FAN: Die Hard Fan |
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/gw/api/data_sp/get_author_fans_distribution/v1?token=YOUR_API_KEY&oAuthorId=VALUE"text
I want to use the "Author Fans Distribution (V1)" API from Just One API.
API Endpoint: https://api.justoneapi.com/api/douyin-xingtu/gw/api/data_sp/get_author_fans_distribution/v1
HTTP Method: GET
Authentication: Append "?token=YOUR_API_KEY" to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/douyin-xingtu-apis/author-fans-distribution-v1-en.json
Parameters:
- token (query): User authentication token. (Required)
- oAuthorId (query): Author's unique ID. (Required)
- authorType (query): Author type filter.
Available Values:
- `FAN`: Fan
- `DIE_HARD_FAN`: Die Hard Fan
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/gw/api/data_sp/get_author_fans_distribution/v1?token=YOUR_API_KEY&oAuthorId=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/gw/api/data_sp/get_author_fans_distribution/v1?token=YOUR_API_KEY&oAuthorId=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/gw/api/data_sp/get_author_fans_distribution/v1?token=YOUR_API_KEY&oAuthorId=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/gw/api/data_sp/get_author_fans_distribution/v1?token=YOUR_API_KEY&oAuthorId=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/gw/api/data_sp/get_author_fans_distribution/v1?token=YOUR_API_KEY&oAuthorId=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": "分布最多的3个省份广东(12%),江苏(7%),浙江(6%)",
"distribution_list": [
{
"distribution_key": "香港",
"distribution_value": "75395"
},
{
"distribution_key": "福建",
"distribution_value": "1357337"
},
{
"distribution_key": "吉林",
"distribution_value": "533097"
},
{
"distribution_key": "江苏",
"distribution_value": "2967497"
},
{
"distribution_key": "广西",
"distribution_value": "1051394"
},
{
"distribution_key": "宁夏",
"distribution_value": "160140"
},
{
"distribution_key": "台湾",
"distribution_value": "35908"
},
{
"distribution_key": "云南",
"distribution_value": "937277"
},
{
"distribution_key": "青海",
"distribution_value": "89837"
},
{
"distribution_key": "辽宁",
"distribution_value": "1001192"
},
{
"distribution_key": "山西",
"distribution_value": "861436"
},
{
"distribution_key": "河北",
"distribution_value": "1803586"
},
{
"distribution_key": "广东",
"distribution_value": "5022865"
},
{
"distribution_key": "黑龙江",
"distribution_value": "651852"
},
{
"distribution_key": "上海",
"distribution_value": "911265"
},
{
"distribution_key": "贵州",
"distribution_value": "781271"
},
{
"distribution_key": "四川",
"distribution_value": "1993387"
},
{
"distribution_key": "北京",
"distribution_value": "827024"
},
{
"distribution_key": "澳门",
"distribution_value": "16560"
},
{
"distribution_key": "内蒙古",
"distribution_value": "568038"
},
{
"distribution_key": "新疆",
"distribution_value": "469390"
},
{
"distribution_key": "浙江",
"distribution_value": "2531368"
},
{
"distribution_key": "重庆",
"distribution_value": "919452"
},
{
"distribution_key": "山东",
"distribution_value": "2524868"
},
{
"distribution_key": "安徽",
"distribution_value": "1613291"
},
{
"distribution_key": "河南",
"distribution_value": "2463373"
},
{
"distribution_key": "甘肃",
"distribution_value": "459459"
},
{
"distribution_key": "湖南",
"distribution_value": "1664129"
},
{
"distribution_key": "海南",
"distribution_value": "269520"
},
{
"distribution_key": "陕西",
"distribution_value": "1065132"
},
{
"distribution_key": "天津",
"distribution_value": "451927"
},
{
"distribution_key": "江西",
"distribution_value": "1143643"
},
{
"distribution_key": "西藏",
"distribution_value": "45151"
},
{
"distribution_key": "湖北",
"distribution_value": "1721824"
}
],
"image": [
"广东,江苏,浙江居多"
],
"origin_type": 2,
"type": 4,
"type_display": "省份分布"
},
{
"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": "分布最多的1个城市广州(12%)",
"distribution_list": [
{
"distribution_key": "武汉",
"distribution_value": "682298"
},
{
"distribution_key": "苏州",
"distribution_value": "637191"
},
{
"distribution_key": "杭州",
"distribution_value": "627586"
},
{
"distribution_key": "东莞",
"distribution_value": "606157"
},
{
"distribution_key": "北京",
"distribution_value": "827144"
},
{
"distribution_key": "成都",
"distribution_value": "796050"
},
{
"distribution_key": "上海",
"distribution_value": "911143"
},
{
"distribution_key": "深圳",
"distribution_value": "859958"
},
{
"distribution_key": "广州",
"distribution_value": "986112"
},
{
"distribution_key": "重庆",
"distribution_value": "919450"
}
],
"image": [
"广州居多"
],
"origin_type": 8,
"type": 256,
"type_display": "城市分布"
},
{
"description": "苹果手机占比25%, 消费能力较好",
"distribution_list": [
{
"distribution_key": "荣耀",
"distribution_value": "3363857"
},
{
"distribution_key": "oppo",
"distribution_value": "4107723"
},
{
"distribution_key": "vivo",
"distribution_value": "4853690"
},
{
"distribution_key": "华为",
"distribution_value": "5654144"
},
{
"distribution_key": "小米",
"distribution_value": "3126675"
},
{
"distribution_key": "红米",
"distribution_value": "2132582"
},
{
"distribution_key": "iPhone",
"distribution_value": "10663765"
},
{
"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": "小镇青年居多,占比24%",
"distribution_list": [
{
"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"
},
{
"distribution_key": "新锐白领",
"distribution_value": "6010031"
},
{
"distribution_key": "都市蓝领",
"distribution_value": "5001909"
}
],
"image": [
"小镇青年居多"
],
"origin_type": 10,
"type": 1024,
"type_display": "八大人群分布"
},
{
"description": "分布最多的3个兴趣随拍(49%),游戏(14%),二次元(12%)",
"distribution_list": [
{
"distribution_key": "随拍",
"distribution_value": "12993670"
},
{
"distribution_key": "游戏",
"distribution_value": "3754214"
},
{
"distribution_key": "亲子",
"distribution_value": "1377126"
},
{
"distribution_key": "二次元",
"distribution_value": "3255252"
},
{
"distribution_key": "体育",
"distribution_value": "1472028"
},
{
"distribution_key": "社会时政",
"distribution_value": "1396900"
},
{
"distribution_key": "美食",
"distribution_value": "1050770"
},
{
"distribution_key": "动物",
"distribution_value": "1031695"
}
],
"image": [
"随拍,游戏,二次元居多"
],
"origin_type": 6,
"type": 64,
"type_display": "兴趣分布"
},
{
"description": "31到40岁居多,占比30%",
"distribution_list": [
{
"distribution_key": "31-40",
"distribution_value": "10514871"
},
{
"distribution_key": "24-30",
"distribution_value": "8535030"
},
{
"distribution_key": "41-50",
"distribution_value": "3533580"
},
{
"distribution_key": "18-23",
"distribution_value": "10314969"
},
{
"distribution_key": "50+",
"distribution_value": "2034223"
}
],
"image": [
"31到40岁居多"
],
"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.