Douyin Xingtu APIs - KOL Follower Trend (V1)
prod-global
GET
/api/douyin-xingtu/get-kol-daily-fans/v1
Get author's historical daily fans growth trend.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
token | query | string | Yes | User authentication token. |
kolId | query | string | Yes | KOL ID. |
startDate | query | string | Yes | Start Date (yyyy-MM-dd). |
endDate | query | string | Yes | End Date (yyyy-MM-dd). |
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-daily-fans/v1?token=YOUR_API_KEY&kolId=VALUE&startDate=VALUE&endDate=VALUE"text
I want to use the "KOL Follower Trend (V1)" API from Just One API.
API Endpoint: https://api.justoneapi.com/api/douyin-xingtu/get-kol-daily-fans/v1
HTTP Method: GET
Authentication: Append "?token=YOUR_API_KEY" to the URL.
OpenAPI Definition: https://docs.justoneapi.com/openapi/douyin-xingtu-apis/kol-follower-trend-v1-en.json
Parameters:
- token (query): User authentication token. (Required)
- kolId (query): KOL ID. (Required)
- startDate (query): Start Date (yyyy-MM-dd). (Required)
- endDate (query): End Date (yyyy-MM-dd). (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-daily-fans/v1?token=YOUR_API_KEY&kolId=VALUE&startDate=VALUE&endDate=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-daily-fans/v1?token=YOUR_API_KEY&kolId=VALUE&startDate=VALUE&endDate=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-daily-fans/v1?token=YOUR_API_KEY&kolId=VALUE&startDate=VALUE&endDate=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-daily-fans/v1?token=YOUR_API_KEY&kolId=VALUE&startDate=VALUE&endDate=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-daily-fans/v1?token=YOUR_API_KEY&kolId=VALUE&startDate=VALUE&endDate=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": ""
},
"daily": [
{
"date": "2026-02-07",
"fans_cnt": "2492026"
},
{
"date": "2026-02-08",
"fans_cnt": "2491357"
},
{
"date": "2026-02-09",
"fans_cnt": "2490707"
},
{
"date": "2026-02-10",
"fans_cnt": "2490038"
},
{
"date": "2026-02-11",
"fans_cnt": "2490083"
},
{
"date": "2026-02-12",
"fans_cnt": "2489969"
},
{
"date": "2026-02-13",
"fans_cnt": "2489612"
},
{
"date": "2026-02-14",
"fans_cnt": "2489420"
},
{
"date": "2026-02-15",
"fans_cnt": "2489297"
},
{
"date": "2026-02-16",
"fans_cnt": "2489137"
},
{
"date": "2026-02-17",
"fans_cnt": "2488850"
},
{
"date": "2026-02-18",
"fans_cnt": "2488620"
},
{
"date": "2026-02-19",
"fans_cnt": "2488311"
},
{
"date": "2026-02-20",
"fans_cnt": "2487605"
},
{
"date": "2026-02-21",
"fans_cnt": "2486812"
},
{
"date": "2026-02-22",
"fans_cnt": "2486306"
},
{
"date": "2026-02-23",
"fans_cnt": "2486286"
},
{
"date": "2026-02-24",
"fans_cnt": "2486434"
},
{
"date": "2026-02-25",
"fans_cnt": "2485894"
},
{
"date": "2026-02-26",
"fans_cnt": "2485051"
},
{
"date": "2026-02-27",
"fans_cnt": "2484823"
},
{
"date": "2026-02-28",
"fans_cnt": "2484243"
},
{
"date": "2026-03-01",
"fans_cnt": "2483894"
},
{
"date": "2026-03-02",
"fans_cnt": "2483528"
},
{
"date": "2026-03-03",
"fans_cnt": "2483334"
},
{
"date": "2026-03-04",
"fans_cnt": "2483057"
},
{
"date": "2026-03-05",
"fans_cnt": "2482752"
},
{
"date": "2026-03-06",
"fans_cnt": "2482454"
},
{
"date": "2026-03-07",
"fans_cnt": "2482584"
},
{
"date": "2026-03-08",
"fans_cnt": "2483138"
}
],
"delta": [
{
"date": "2026-02-07",
"fans_cnt": "-395"
},
{
"date": "2026-02-08",
"fans_cnt": "-669"
},
{
"date": "2026-02-09",
"fans_cnt": "-650"
},
{
"date": "2026-02-10",
"fans_cnt": "-669"
},
{
"date": "2026-02-11",
"fans_cnt": "45"
},
{
"date": "2026-02-12",
"fans_cnt": "-114"
},
{
"date": "2026-02-13",
"fans_cnt": "-357"
},
{
"date": "2026-02-14",
"fans_cnt": "-192"
},
{
"date": "2026-02-15",
"fans_cnt": "-123"
},
{
"date": "2026-02-16",
"fans_cnt": "-160"
},
{
"date": "2026-02-17",
"fans_cnt": "-287"
},
{
"date": "2026-02-18",
"fans_cnt": "-230"
},
{
"date": "2026-02-19",
"fans_cnt": "-309"
},
{
"date": "2026-02-20",
"fans_cnt": "-706"
},
{
"date": "2026-02-21",
"fans_cnt": "-793"
},
{
"date": "2026-02-22",
"fans_cnt": "-506"
},
{
"date": "2026-02-23",
"fans_cnt": "-20"
},
{
"date": "2026-02-24",
"fans_cnt": "148"
},
{
"date": "2026-02-25",
"fans_cnt": "-540"
},
{
"date": "2026-02-26",
"fans_cnt": "-843"
},
{
"date": "2026-02-27",
"fans_cnt": "-228"
},
{
"date": "2026-02-28",
"fans_cnt": "-580"
},
{
"date": "2026-03-01",
"fans_cnt": "-349"
},
{
"date": "2026-03-02",
"fans_cnt": "-366"
},
{
"date": "2026-03-03",
"fans_cnt": "-194"
},
{
"date": "2026-03-04",
"fans_cnt": "-277"
},
{
"date": "2026-03-05",
"fans_cnt": "-305"
},
{
"date": "2026-03-06",
"fans_cnt": "-298"
},
{
"date": "2026-03-07",
"fans_cnt": "130"
},
{
"date": "2026-03-08",
"fans_cnt": "554"
}
],
"description": "",
"fans_advice": "",
"fans_growth": "0",
"fans_growth_rate": 0,
"fans_growth_rate_v2": {
"value": -35
},
"fans_growth_v2": {
"value": -8888
},
"raw_play_rate": {}
}
}💡 Note: For list data, the example shows only 1-2 items for simplicity. The actual count depends on the API response.