SocialToAIStart freeConsole
POST/v1/call/douyin.account_metricsPreview

Douyin trend-index creator core metrics API

Only on Douyin.

The Douyin trend-index creator core metrics API returns a Douyin creator's core figures from the platform's own index tool, by the account's numeric ID. 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.

Start for freeSign in to run
100 credits on sign-up, no card needed
2 creditsper call
One objectreturned per call
2026-10-17last tested
1.1 KBsample response, 1 item

Last updated:

Preview: this interface is not marked stable yet, so its parameters and fields may still change. It is charged like any other call, and a failed call is not charged.

Request and response

curl https://api.socialtoai.com/v1/call/douyin.account_metrics \  -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_metrics",    headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"},    json={        "id": "66598046050",    },)print(response.json())
# Connected over MCP? Ask in plain words.Use the Douyin trend-index creator core metrics interface (douyin.account_metrics) with id: 66598046050.# Your AI calls the call tool with:{  "id": "66598046050"}
Sign in to run2 creditsOpens in the Playground with these parameters after you sign in. It never runs by itself.
200 OK1.1 KB2 credits
{  "op": "douyin.account_metrics",  "platform": "douyin",  "status": "ok",  "items": [    {      "platform": "douyin",      "id": "…",      "ref": "…",      "approx": [],      "type": "entry",      "entry_type": "index_creator_metrics",      "title": null,      "url": null,      "rank": null,      "heat": null,      "fields": {        "average_7d": {          "likes": 157100.7142857143,          "followers": 3588,          "shares": 14715.42857142857,          "comments": 3879.8571428571427        },        "average_30d": {          "likes": 300077.7,          "followers": 6233.6,          "shares": 17969.833333333332,          "comments": 7351.466666666666        },        "change_7d": {          "likes": -0.20028666505711482,          "followers": -0.1607298001737619,          "shares": 0.8577740905729795,          "comments": -0.28813692598028945        },        "change_30d": {          "likes": -0.12000717497205526,          "followers": -0.1316211058123174,          "shares": -0.1697698557902584,          "comments": -0.23841359186421957        }      }    }  ],  "unavailable": [],  "cost_credits": 2}
entry_type
index_creator_metrics

Names and text were removed from the sample; the numbers are as recorded.

Sample dataFull response

1 parameter.
All required.

Send them as a JSON body with POST. Your key goes in the Authorization header, never in the URL.

NameTypeRequiredDefaultDescription
idstringRequired—The account's numeric Douyin ID (uid), a string of digits; not the token starting with MS4w that the profile endpoint takes

Where to get what you send.

id

The 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.

FieldTypeMeaning
items[].titlestringThe entry's title or name.
items[].urlstringA link that opens it; null where the platform's list has none.
items[].rankintegerPosition on a board, from 1.
items[].heatintegerThe platform's heat score.
items[].fields.average_7d.likesnumberNew likes a day, on average over the last week.
items[].fields.average_7d.followersnumberNew followers a day, on average over the last week.
items[].fields.average_7d.sharesnumberNew shares a day, on average over the last week.
items[].fields.average_7d.commentsnumberNew comments a day, on average over the last week.
items[].fields.average_30d.likesnumberNew likes a day, on average over the last month.
items[].fields.average_30d.followersnumberNew followers a day, on average over the last month.
items[].fields.average_30d.sharesnumberNew shares a day, on average over the last month.
items[].fields.average_30d.commentsnumberNew comments a day, on average over the last month.
items[].fields.change_7d.likesnumberNew likes a day over the last week compared with the week before, as a ratio.
items[].fields.change_7d.followersnumberNew followers a day over the last week compared with the week before, as a ratio.
items[].fields.change_7d.sharesnumberNew shares a day over the last week compared with the week before, as a ratio.
items[].fields.change_7d.commentsnumberNew comments a day over the last week compared with the week before, as a ratio.
items[].fields.change_30d.likesnumberNew likes a day over the last month compared with the month before, as a ratio.
items[].fields.change_30d.followersnumberNew followers a day over the last month compared with the month before, as a ratio.
items[].fields.change_30d.sharesnumberNew shares a day over the last month compared with the month before, as a ratio.
items[].fields.change_30d.commentsnumberNew comments a day over the last month compared with the month before, as a ratio.
nullFields Douyin cannot give

Douyin 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.

One call returns one object, with no pages, for 2 credits.

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.

  1. Get a Douyin creator's core figures from the platform's own index tool, by the account's numeric ID: 66598046050.
    call {"op":"douyin.account_metrics","id":"66598046050"}
    2 credits

Questions.
Short answers.

Everything on Douyin
Do I need a Douyin account or Douyin's own API access?
No. You only need a SocialToAI key. The call returns content and account information publicly visible on Douyin; you never sign in to Douyin or apply for anything there.
What does “Preview” mean here?
Preview: this interface is not marked stable yet, so its parameters and fields may still change. It is charged like any other call, and a failed call is not charged.

Your AI is one URL away
from all of social media.

Start for freeDocs

100 credits on sign-up, no card needed