# Fixed reference example. Playground inputs do not update this sample.
curl --request POST \
--url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"cookie": "Your_Cookie_Here"
}'curl --request POST \
--url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"cookie": "Your_Cookie_Here"
}
'import requests
url = "https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis"
payload = { "cookie": "Your_Cookie_Here" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({cookie: 'Your_Cookie_Here'})
};
fetch('https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'cookie' => 'Your_Cookie_Here'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis"
payload := strings.NewReader("{\n \"cookie\": \"Your_Cookie_Here\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"cookie\": \"Your_Cookie_Here\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"cookie\": \"Your_Cookie_Here\"\n}"
response = http.request(request)
puts response.read_body{
"cache_message": "This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.",
"cache_message_zh": "本次响应已缓存,可通过下方 URL 直接查看,有效期 24 小时,访问缓存链接无额外费用。缓存仅用于请求溯源,不影响接口数据的时效性,也不会再次通过接口返回。",
"cache_url": "<string>",
"code": 200,
"data": "<unknown>",
"docs": "<string>",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {},
"request_id": "<string>",
"router": "",
"support": "Discord: https://discord.gg/aMEAS8Xsvz",
"time": "<string>",
"time_stamp": 123,
"time_zone": "America/Los_Angeles"
}douyin fetch_author_diagnosis
Fetch author diagnosis
# Fixed reference example. Playground inputs do not update this sample.
curl --request POST \
--url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"cookie": "Your_Cookie_Here"
}'curl --request POST \
--url https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"cookie": "Your_Cookie_Here"
}
'import requests
url = "https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis"
payload = { "cookie": "Your_Cookie_Here" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({cookie: 'Your_Cookie_Here'})
};
fetch('https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'cookie' => 'Your_Cookie_Here'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis"
payload := strings.NewReader("{\n \"cookie\": \"Your_Cookie_Here\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"cookie\": \"Your_Cookie_Here\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"cookie\": \"Your_Cookie_Here\"\n}"
response = http.request(request)
puts response.read_body{
"cache_message": "This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.",
"cache_message_zh": "本次响应已缓存,可通过下方 URL 直接查看,有效期 24 小时,访问缓存链接无额外费用。缓存仅用于请求溯源,不影响接口数据的时效性,也不会再次通过接口返回。",
"cache_url": "<string>",
"code": 200,
"data": "<unknown>",
"docs": "<string>",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {},
"request_id": "<string>",
"router": "",
"support": "Discord: https://discord.gg/aMEAS8Xsvz",
"time": "<string>",
"time_stamp": 123,
"time_zone": "America/Los_Angeles"
}code is 200.
Example
curl -X POST "https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{}' # see request schema below
Request contract
- Method and path: POST /apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis
- Availability: enabled
- Request URL template:
https://api.aisa.one/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis - Runtime facts: 85ae03121f63417c9ff9d57a0fd59fdc6386fd71e2dc732a002843e6d8979d87
{
"operationId": "post_tikhub_douyin_creator_v2_fetch_author_diagnosis",
"method": "POST",
"path": "/apis/v1/tikhub/douyin/creator_v2/fetch_author_diagnosis",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [],
"security": [
{
"bearerAuth": []
}
],
"requestBody": {
"content": {
"application/json": {
"example": {
"cookie": "Your_Cookie_Here"
},
"schema": {
"allOf": [
{
"description": "Author Diagnosis Request Model\n\nThis API requires no additional parameters, automatically fetches diagnosis data for the past 7 days",
"properties": {
"cookie": {
"description": "User's Douyin Creator Platform Cookie (required)",
"example": "Your_Cookie_Here",
"title": "Cookie",
"type": "string"
}
},
"required": [
"cookie"
],
"title": "AuthorDiagnosisRequest",
"type": "object"
}
],
"description": "Author diagnosis request parameters"
}
}
},
"required": true
},
"x-aisa-status": "enabled",
"x-aisa-pricing": {
"cost_contract": "fixed_success",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.001,
"estimate_source": "profile_seed",
"evidence_source": "request_snapshot"
},
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
Cost and request rules
Published reference price: $0.001 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.- Default request reference estimate (USD): 0.001
- Cost contract: fixed_success
- Published reference multiplier: 1.0
- Settlement evidence source: request_snapshot
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Author diagnosis request parameters
User's Douyin Creator Platform Cookie (required)
"Your_Cookie_Here"
Response
Successful response. The outer object follows ResponseModel; the endpoint-specific payload is in data.
Return Data Description
Account diagnosis data including five core dimensions:
1. Engagement Index (Interact):
- OwnValue: Account's own engagement index value (comprehensive score of views, likes, comments, shares)
- SimilarCount: Total number of similar creators
- AuthorRank: Ranking percentile in account's historical data (0-1, higher means better current performance)
- SimilarRank: Ranking percentile among similar creators (0-1, higher means better ranking)
- SimilarValue: Average engagement index value of similar creators
- Interpretation: AuthorRank=0.26 means current engagement exceeds 26% of own history
- Interpretation: SimilarRank=0.52 means ranking exceeds 52% of similar creators
2. Net Fan Growth (NewFans):
- OwnValue: Net increase in followers during the period (new followers - unfollowers)
- SimilarCount: Total number of similar creators
- AuthorRank: Ranking percentile in account's historical fan growth data
- SimilarRank: Fan growth ranking percentile among similar creators
- SimilarValue: Average net fan growth of similar creators
- Interpretation: OwnValue=2 means net gain of 2 followers in this period
3. Video Views (PlayCnt):
- OwnValue: Total number of times works were viewed during the period
- SimilarCount: Total number of similar creators
- AuthorRank: Ranking percentile in account's historical view count
- SimilarRank: View count ranking percentile among similar creators
- SimilarValue: Average view count of similar creators
- Interpretation: OwnValue=192 means total views of 192 in this period
4. Video Completion Rate (PlayFinishRatio):
- OwnValue: Proportion of complete playbacks (decimal between 0-1)
- SimilarCount: Total number of similar creators
- AuthorRank: Ranking percentile in account's historical completion rate
- SimilarRank: Completion rate ranking percentile among similar creators
- SimilarValue: Average completion rate of similar creators
- Interpretation: OwnValue=0.15 means 15% completion rate
- Tip: Focus on first 3 seconds to improve retention
5. Publishing Activity (PublishActivation):
- OwnValue: Number of works published during the period
- SimilarCount: Total number of similar creators
- AuthorRank: Ranking percentile in account's historical publishing data
- SimilarRank: Publishing activity ranking percentile among similar creators
- SimilarValue: Average number of submissions by similar creators
- Interpretation: OwnValue=2 means published 2 works in this period
Return Data Structure Example
{
"code": 0,
"data": {
"Interact": {
"OwnValue": 0.0052,
"SimilarCount": 1494654282,
"AuthorRank": 0.2633,
"SimilarRank": 0.5169,
"SimilarValue": 0.0909
},
"NewFans": {
"OwnValue": 2,
"AuthorRank": 0.7924,
"SimilarRank": 0.6343
},
"PlayCnt": {
"OwnValue": 192,
"AuthorRank": 0.8427,
"SimilarRank": 0.5132
},
"PlayFinishRatio": {
"OwnValue": 0.1545,
"AuthorRank": 0.3851,
"SimilarRank": 0.5086
},
"PublishActivation": {
"OwnValue": 2,
"AuthorRank": 0.7345,
"SimilarRank": 0.5675
}
}
}
Cache message (EN-US)
Cache message (ZH-CN)
The URL to access the cached result
HTTP status code
Endpoint-specific response payload. The official shared model does not declare a fixed type or field set. Use the operation's documented return fields or response example; an operation-specific schema, when present, describes the documented fields. Undocumented fields must be read from the actual response rather than assumed.
Link to the API Swagger documentation for this endpoint
Response message (EN-US)
Response message (ZH-CN)
The parameters used in the request
Unique request identifier
The endpoint that generated this response
Support message
The time the response was generated
The timestamp the response was generated
The timezone of the response time