Accounts & creatorsDouyinCreator Metrics · Compare
Douyin creator engagement and follower trends
Compare follower and engagement changes for up to five creators over 7 or 30 days.
POST
/v1/douyin/creators/trends/compareChinese name: 抖音达人互动与粉丝趋势 · 达人指标 · 对比 对比最多 5 位公开达人近 7 天或 30 天的涨粉与互动变化。douyin.creators.trends.compare@v1
Price per call
¥0.05/ call
Complete and confirmed empty results are charged; partial results and failures are not.
Checking live statusTry it
This API is coming soon
We are running launch checks. Once live, you can try it right here at the price shown above; nothing is charged before then. You can already read the parameters and response example.
Available now on the same platform
- Douyin user profile
- Douyin user videos
- Douyin similar creators
- Douyin Xingtu creator batch info
- Douyin Xingtu creator audience
- Douyin Xingtu creator video performance
- Douyin video detail
- Douyin video search
- Douyin video comments
- Douyin comment replies
- Douyin user search
- Douyin hot search
- Douyin rising trends
- Douyin low-follower viral ranking
- Douyin high-completion ranking
- Douyin mix detail
- Douyin mix videos
- Douyin batch video detail
- Douyin related videos
- Douyin general search
- Douyin music detail
- Douyin videos by music
- Douyin high-like-rate ranking
- Douyin high-follower-conversion ranking
- Douyin hashtag detail
- Douyin hashtag videos
- Douyin Xingtu creator search
- Douyin topic ranking
- Douyin hot search terms
Sign in and run one real call. The result and charge appear right here.
Security check
Loading the security check…
Checking live execution status…
Execution result
// Result
Request parameters
creator_idsarrayrequiredminItems: 1 · maxItems: 5
Example:
["3100268042915212"]window_daysnumberrequiredExample:
7
Request JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"creator_ids": {
"minItems": 1,
"maxItems": 5,
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{5,32}$"
}
},
"window_days": {
"anyOf": [
{
"type": "number",
"const": 7
},
{
"type": "number",
"const": 30
}
]
}
},
"required": [
"creator_ids",
"window_days"
],
"additionalProperties": false
}Code samples
Install the SDK with npm i @dataxapi/sdk or pip install dataxapi, and put your API key in the DATAXAPI_API_KEY environment variable.
curl -X POST https://api.dataxapi.com/v1/douyin/creators/trends/compare \
-H "Authorization: Bearer $DATAXAPI_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"creator_ids":["3100268042915212"],"window_days":7}'import { ExactApiClient } from "@dataxapi/sdk";
const client = new ExactApiClient({
baseUrl: "https://api.dataxapi.com",
apiKey: process.env.DATAXAPI_API_KEY,
});
const result = await client.call("douyin_creators_trends_compare_v1", {
"creator_ids": [
"3100268042915212"
],
"window_days": 7
});
console.log(result.data);import os
from dataxapi import ExactApiClient
client = ExactApiClient("https://api.dataxapi.com", os.environ["DATAXAPI_API_KEY"])
result = client.call("douyin_creators_trends_compare_v1", {
"creator_ids": [
"3100268042915212",
],
"window_days": 7,
})
print(result["data"])[mcp_servers.dataxapi]
url = "https://api.dataxapi.com/mcp"
bearer_token_env_var = "DATAXAPI_API_KEY"Response example
200 · application/json
{
"code": 200,
"request_id": "req_example_douyin_batch5_social",
"message": "success",
"data": {
"window_days": 7,
"items": [
{
"queried_creator_id": "3100268042915212",
"name": "Public creator",
"profile_url": "https://www.douyin.com/user/MS4wLjABAAAA-public",
"avatar_url": "https://ci.douyin.com/avatar",
"current": {
"followers": 450148,
"likes": 6337607,
"videos": 55
},
"period_total": {
"followers": 3994,
"likes": 64811,
"shares": 8605,
"comments": 242,
"videos": 1
},
"daily_average": {
"followers": 1032,
"likes": 9258,
"shares": 1230,
"comments": 34,
"videos": null
},
"change_vs_previous_period": {
"followers": -0.3424,
"likes": -0.3558,
"shares": -0.427,
"comments": 0.1524,
"videos": 0
}
}
]
},
"page": {
"next_cursor": null
},
"warnings": [],
"meta": {
"listing_id": "douyin.creators.trends.compare",
"version": "v1",
"catalog_release_id": "catalog-production-2026-09-19.b069be57",
"price_book_version": "pricebook-production-2026-09-19.4487e352",
"result_status": "complete",
"charged_amount": "0.05",
"balance_after": "49.95",
"currency": "CNY"
}
}Response fields
codenumber- const: 200
request_idstringmessagestring- const: "success"
dataobjectpageobjectwarningsarraymetaobject
Response JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"code": {
"type": "number",
"const": 200
},
"request_id": {
"type": "string"
},
"message": {
"type": "string",
"const": "success"
},
"data": {
"type": "object",
"properties": {
"window_days": {
"anyOf": [
{
"type": "number",
"const": 7
},
{
"type": "number",
"const": 30
}
]
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"queried_creator_id": {
"type": "string"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"current": {
"type": "object",
"properties": {
"followers": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"likes": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"videos": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"followers",
"likes",
"videos"
],
"additionalProperties": false
},
"period_total": {
"type": "object",
"properties": {
"followers": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"likes": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"shares": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"comments": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"videos": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"followers",
"likes",
"shares",
"comments",
"videos"
],
"additionalProperties": false
},
"daily_average": {
"type": "object",
"properties": {
"followers": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"likes": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"shares": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"comments": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"videos": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"followers",
"likes",
"shares",
"comments",
"videos"
],
"additionalProperties": false
},
"change_vs_previous_period": {
"type": "object",
"properties": {
"followers": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"likes": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"shares": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"comments": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"videos": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"followers",
"likes",
"shares",
"comments",
"videos"
],
"additionalProperties": false
}
},
"required": [
"queried_creator_id",
"name",
"profile_url",
"avatar_url",
"current",
"period_total",
"daily_average",
"change_vs_previous_period"
],
"additionalProperties": false
}
}
},
"required": [
"window_days",
"items"
],
"additionalProperties": false
},
"page": {
"type": "object",
"properties": {
"next_cursor": {
"type": "null"
}
},
"required": [
"next_cursor"
],
"additionalProperties": false
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"meta": {
"type": "object",
"properties": {
"listing_id": {
"type": "string",
"const": "douyin.creators.trends.compare"
},
"version": {
"type": "string",
"const": "v1"
},
"catalog_release_id": {
"type": "string",
"minLength": 1
},
"price_book_version": {
"type": "string",
"minLength": 1
},
"result_status": {
"type": "string",
"enum": [
"complete",
"empty",
"partial"
]
},
"charged_amount": {
"type": "string"
},
"balance_after": {
"type": "string"
},
"currency": {
"type": "string",
"const": "CNY"
}
},
"required": [
"listing_id",
"version",
"catalog_release_id",
"price_book_version",
"result_status",
"charged_amount",
"balance_after",
"currency"
],
"additionalProperties": false
}
},
"required": [
"code",
"request_id",
"message",
"data",
"page",
"warnings",
"meta"
],
"additionalProperties": false
}Usage notes
Good for
- Use it to compare bounded current performance windows across known creator UIDs.
Not for
- Do not use it as causal attribution, a forecast, or private creator analytics.
Known limitations
- At most five unique creator UIDs and only 7- or 30-day windows.
- Every returned identity is verified against the requested UID set before request order is restored.
- Comparison rates do not establish causality.
Billing
¥0.05 per call. Complete and confirmed empty results are charged; partial results and failures are not.
See all pricing →