/v1/call/douyin.account_historyPreviewDouyin creator engagement and follower trends API
Only on Douyin.
The Douyin creator engagement and follower trends API returns how a Douyin account's numbers moved over the last 7 or 30 days, by its numeric ID, from the platform's own index tool. One call costs 2 credits ($0.004 to $0.0067 depending on the pack); failed calls are free. Call it over HTTP or from your AI client over MCP. Last tested 2026-10-17.
Last updated:
Request and response
curl https://api.socialtoai.com/v1/call/douyin.account_history \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "id": "66598046050" }'import osimport requestsresponse = requests.post( "https://api.socialtoai.com/v1/call/douyin.account_history", headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"}, json={ "id": "66598046050", },)print(response.json())# Connected over MCP? Ask in plain words.Use the Douyin creator engagement and follower trends interface (douyin.account_history) with id: 66598046050.# Your AI calls the call tool with:{ "id": "66598046050"}window{ "op": "douyin.account_history", "platform": "douyin", "status": "ok", "items": [ { "platform": "douyin", "id": "…", "ref": "…", "approx": [], "type": "entry", "entry_type": "account_history", "title": "…", "url": "https://example.com/…", "rank": null, "heat": null, "fields": { "days": 30, "gained": { "followers": 661489, "likes": 255080710, "comments": 48099, "shares": 38207194, "posts": 437 }, "change": { "followers": 0.7285514941831903, "likes": 0.2256968601585644, "comments": -0.12905153369789593, "shares": 0.04085150466802108, "posts": -0.126 }, "totals": { "followers": 203357430, "likes": 19128275335, "posts": 12381 } } } ], "unavailable": [], "cost_credits": 2}- entry_type
- account_history
- days
- 30
Names and text were removed from the sample; the numbers are as recorded.
2 parameters.
1 required.
Send them as a JSON body with POST. Your key goes in the Authorization header, never in the URL.
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string | Required | — | The account's numeric Douyin ID (uid), a string of digits; not the token starting with MS4w that the profile endpoint takes |
| window | string | Optional | "7d" | How many of the most recent days to count: 7 or 30"7d""30d" |
Where to get what you send.
idThe account's numeric Douyin ID (uid), a string of digits; not the token starting with MS4w that the profile endpoint takes (e.g. 66598046050)
No other interface of the platform returns it: take it from the web page or link as described above.
The fields of each item.
What Douyin cannot give is marked.
| Field | Type | Meaning |
|---|---|---|
| items[].title | string | The entry's title or name. |
| items[].url | string | A link that opens it; null where the platform's list has none. |
| items[].rank | integer | Position on a board, from 1. |
| items[].heat | integer | The platform's heat score. |
| items[].fields.days | integer | How many of the most recent days the figures cover. |
| items[].fields.gained.followers | integer | Net new followers; negative when followers were lost. |
| items[].fields.gained.likes | integer | New likes. |
| items[].fields.gained.comments | integer | New comments. |
| items[].fields.gained.shares | integer | New shares. |
| items[].fields.gained.posts | integer | Posts published. |
| items[].fields.change.followers | number | Net new followers compared with the period before, as a ratio. |
| items[].fields.change.likes | number | New likes compared with the period before, as a ratio. |
| items[].fields.change.comments | number | New comments compared with the period before, as a ratio. |
| items[].fields.change.shares | number | New shares compared with the period before, as a ratio. |
| items[].fields.change.posts | number | Posts published compared with the period before, as a ratio. |
| items[].fields.totals.followers | integer | Followers now. |
| items[].fields.totals.likes | integer | Likes received in total. |
| items[].fields.totals.posts | integer | Posts published in total. |
nullFields Douyin cannot giveDouyin gives every field of this call. Where one item lacks a value, that field is null.
Every item also has platform, id, ref, approx and type; the response around the items is the same on every call. Response format
What to expect.
1 call per second per key, 5 after a purchase; going over is not charged. Rate limits
A failed call costs 0 credits and is never retried on its own. Error codes
Once connected over MCP, these questions use it.
Get how a Douyin account's numbers moved over the last 7 or 30 days, by its numeric ID, from the platform's own index tool: 66598046050.
2 creditscall {"op":"douyin.account_history","id":"66598046050"}Get how a Douyin account's numbers moved over the last 7 or 30 days, by its numeric ID, from the platform's own index tool: 66598046050, with window set to 30d.
2 creditscall {"op":"douyin.account_history","id":"66598046050","window":"30d"}