Douyin Account Analytics Scraper

Get analytics for any public Douyin account: the hot-account board and account search, a follower-growth trend, weekly performance against peer averages and percentiles, and audience demographics by region, gender, age, and device — normally visible only to the account's own logged-in creator. Pick a mode with scraperType.

Modes

scraperType	Returns	Needs
accountsBoard (default)	Accounts trending by follower and like growth	—
accountSearch	Search the hot-account board by name or handle	keyword
accountTrend	One account's follower-growth trend	sec_user_id
accountAnalysis	One account's weekly posts vs. its peer group, average and percentile	sec_user_id
accountAudience	One account's follower demographics — region, gender, age, device	sec_user_id
accountAudienceAccounts	The other accounts one account's audience also follows	sec_user_id

Input

Field	Use it for
sec_user_id	A profile URL or sec_user_id. Required for every mode except accountsBoard and accountSearch.
keyword	Required for accountSearch.
date_window	accountsBoard only. Hours: 1 past hour, 24 past day (default), 168 past week, 720 past month.
option	accountTrend (default 2) and accountAudience (default 1) only. Integer 1–9 — 0 and 10 are both rejected.
addonProfileDetails	Every mode except accountTrend. Fetches full profile detail for each account — one extra request and one extra charge per row.
maxItems	Caps accountsBoard and accountSearch. Default 100. Set 0 for no limit.

{
  "scraperType": "accountTrend",
  "sec_user_id": "MS4wLjABAAAAY3J1P0y5w7hzttTyvZiLjhMu3iOzF-1yFi6yNtXVHzkmVGFIx7T8s-nRmGNusfh1"
}

accountTrend is one row, not one row per data point

A follower-trend request returns the account's whole series in a single upstream call — around 90 points on a weekly window for a large account. This Actor keeps that as one row holding a trends array, rather than exploding it into one row per point. That's deliberate: a row means the same amount of upstream work on every mode in this Actor, not ~90 times more on this one. If you were expecting close to 90 rows out of a trend run, expect one row instead, and read the points out of trends yourself.

Output

Field	Mode	Contents
user_id, sec_uid, nick_name, avatar_url, fans_cnt, like_cnt, publish_cnt, new_like_cnt, new_fans_cnt, fans_trends, fans_incr_rate, second_tag_name, group_name, profile_detail	accountsBoard, accountAudienceAccounts	Each account on the board
Same, plus source_keyword	accountSearch	Each matching account
trends, avg, option, sec_uid, source_sec_user_id	accountTrend	The whole follower-growth series, one row
avg_aweme_count, avg_comment_count, avg_share_count, avg_follower_count, avg_like_count, percentile_aweme_count, percentile_comment_count, percentile_share_count, percentile_follower_count, percentile_like_count, profile_detail	accountAnalysis	Averages and peer percentiles for one week
portrait, portrait_tgi, option, profile_detail	accountAudience	Follower demographic breakdown

{
  "trends": [{ "datetime": "20260805", "value": 4812093 }, { "datetime": "20260806", "value": 4815441 }],
  "avg": 4813200,
  "option": 2,
  "source_sec_user_id": "MS4wLjABAAAAY3J1P0y5w7hzttTyvZiLjhMu3iOzF-1yFi6yNtXVHzkmVGFIx7T8s-nRmGNusfh1"
}

Questions

Why did accountTrend only return one row? By design — see the note above. The row's trends field holds the whole series.

What audience breakdowns does accountAudience cover? Region, gender, age, and device, all in portrait and portrait_tgi. Two further sub-breakdowns Douyin exposes for this board — recent audience searches and audience topics — came back empty on every account tested and are not offered here; accountAudience and accountAudienceAccounts are the two breakdowns that reliably return data.

Why can't I set option to any number I like? The source only accepts integers 1–9; 0 and 10 are both rejected outright. Each mode that uses it keeps its own verified default rather than one shared default, because the meaningful metric differs per mode.

Does accountSearch page automatically? Yes, on the source's own cursor — raise maxItems and the Actor keeps requesting further pages until it's reached or the source runs out.

Related Actors

Actor	Purpose
Douyin Profile Scraper	Basic profile fields — bio, follower count, verification — without the analytics
Douyin Video Analytics Scraper	The same kind of analytics, scoped to one video instead of a whole account
Douyin Trending Scraper	The video, topic, and search boards this account board sits alongside

Support

Questions, bugs, or feature requests: contact@toolzerhub.com

Browse the rest: apify.com/toolzerhub