Account recent change object

The Account recent change object has 18 fields and is returned by 1 endpoint on Douyin. A call costs $0.0020. It is a preview structure and may still change.

Preview object · Updated 2026-10-17Open in ChatGPTOpen in Claude

Account recent change is how a Douyin account's numbers moved over the last 7 or 30 days: net new followers, new likes, comments, shares and posts, each beside its change against the period before. It is one period's sum from Douyin's trend-index (巨量算数), not a day-by-day series.

id is the account's numeric Douyin ID (uid), not the ID the profile endpoint takes, and url is the profile link, which that endpoint takes unchanged. Up to five accounts go in one request with ids.

Fields

A field the platform cannot give is left out of the item and named in meta.unavailable. It is never filled with a guess or a zero.

id text

The account's numeric ID (Douyin's uid): the one the request gave

name text

Display name

url link

Link to the profile; pass it unchanged to the account endpoint

avatar_url link standard

Avatar

days integer

How many of the most recent days the figures cover

gained object

What was gained over the period

gained.followers integer

Net new followers; negative when followers were lost

gained.likes integer

New likes

gained.comments integer

New comments

gained.shares integer

New shares

gained.posts integer

Posts published

change object

Change against the period of the same length before it, as a ratio: 0.3 is 30% more, -0.5 is half as much

change.followers number

Change in net new followers

change.likes number

Change in new likes

change.comments number

Change in new comments

change.shares number

Change in new shares

change.posts number

Change in posts published

totals object standard

The account's totals as of now

totals.followers integer standard

Followers

totals.likes integer standard

Likes received in all

totals.posts integer standard

Posts

Endpoints that return Account recent change

The number beside each platform is how many of its endpoints return it.

EndpointPathPrice
Douyin creator engagement and follower trendsGET/v1/douyin/users/history$0.0020

Example

One item from douyin.users.history, as recorded 2026-10-12 21:54 UTC. Names, text, IDs and links are examples; the figures are as recorded.

Account recent change · douyin.users.history
{
  "id": "65485320678",
  "name": "阿杰爱折腾",
  "url": "https://www.douyin.com/user/65485320678",
  "avatar_url": "https://p3-pc.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_2ed168d1dc1b7e7b888e.jpeg",
  "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 }
}

The whole response is on the endpoint's page →

Related

Other objects