Douyin Profile Scraper
Pricing
from $2.40 / 1,000 results
Douyin Profile Scraper
Extract public Douyin profiles by URL, sec_user_id, uid, or handle. Get nickname, bio, follower and following counts, video count, verification, IP location, gender, and city for one Douyin account or many at once. Export the data, run via API, or schedule recurring pulls.
Pricing
from $2.40 / 1,000 results
Rating
0.0
(0)
Developer
ToolzerHub
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
8 hours ago
Last modified
Categories
Share
Fetch a public Douyin profile — nickname, bio, follower and following counts, video count, verification, IP region, gender, and city — from a profile URL, sec_user_id, numeric uid, or handle (抖音号). Hand it a comma-separated list of sec_user_id values instead and get one row back per account.
Input
| Field | Type | Default | What it does |
|---|---|---|---|
sec_user_id | string | — | A Douyin profile URL, or the sec_user_id it contains. |
sec_user_ids | string | — | Several sec_user_id values, comma-separated. |
uid | string | — | A profile's numeric uid. |
username | string | — | A profile's handle (抖音号), without the leading @. |
maxItems | integer | 100 | Caps how many IDs from sec_user_ids get resolved. 0 resolves the whole list. |
Provide exactly one identifier. The run checks them in this order — sec_user_ids, then sec_user_id, then uid, then username — and uses whichever it finds first.
{ "sec_user_id": "https://www.douyin.com/user/MS4wLjABAAAAY3J1P0y5w7hzttTyvZiLjhMu3iOzF-1yFi6yNtXVHzkmVGFIx7T8s-nRmGNusfh1" }
Output
| Field | Contents |
|---|---|
nickname, unique_id | Display name and handle |
sec_uid, uid, short_id | The three ID forms Douyin uses for this account |
signature | Bio text |
follower_count, following_count, aweme_count | Followers, following, videos published |
total_favorited, favoriting_count | Likes received across all videos, and likes given |
custom_verify, enterprise_verify_reason | Verification label, when verified |
ip_location, gender, city, country | Location and profile fields, when set |
live_status | Whether the account is broadcasting right now |
avatar_larger | Profile picture URLs |
source_sec_user_id | The ID this row was collected for |
Douyin exposes profile lookups through three genuinely different endpoints depending on which identifier you hand it, and this Actor normalizes all three onto the field list above. A lookup by sec_user_id is the richest — it's Douyin's own canonical profile shape. Lookups by uid or username go through thinner endpoints: unique_id, aweme_count, total_favorited, and custom_verify come back empty on the uid path, and uid itself comes back empty on the username path. If a field you need is missing, re-run with sec_user_id instead.
Questions
Why does looking up 5 IDs in sec_user_ids cost 5 requests instead of one?
Douyin's batch profile endpoint rejects every call it's sent — verified live at 1, 2, and 3 IDs — so this Actor serves a comma-separated list as one profiles/info call per ID instead. Same upstream cost either way, just no single-call discount to expect.
What happens if one ID in sec_user_ids is invalid?
That ID is skipped and logged; the rest of the list still runs. One bad ID doesn't fail the whole batch.
Why are some fields blank when I look up by uid or handle instead of sec_user_id?
uid and username resolve through different, thinner Douyin endpoints than the canonical profile lookup. unique_id, aweme_count, total_favorited, and custom_verify are only populated on the sec_user_id path; the uid path also nests follower/following counts differently upstream, which this Actor already unpacks onto follower_count and following_count for you.
Other Douyin Actors
| Actor | Use when |
|---|---|
| Douyin Profile Videos Scraper | You want this account's videos, not just its bio |
| Douyin User Search Scraper | You have a keyword, not yet a sec_user_id |
| Douyin Account Analytics Scraper | You want follower-growth trends and audience demographics for this account |
Support
Questions, bugs, or feature requests: contact@toolzerhub.com
Browse the rest: apify.com/toolzerhub