Douyin Profile Scraper – Chinese TikTok User Data Extractor

Scrape Douyin (Chinese TikTok) user profile details by profile URL or sec_user_id. Extract nickname, bio, followers, following, total likes, video count, avatar, cover image, IP location, verification status, live status, and more. Supports bulk profile lookups. Built with Apify best practices for reliability and speed.

---

Table of Contents

• Features
• Use Cases
• Quick Start
• Input Parameters
• Output Format
• Performance & Limits
• FAQ
• Troubleshooting
• Tags

---

Features

• Profile Lookup by URL or ID – Fetch detailed Douyin user profiles using profile URLs or sec_user_id values.
• Bulk Lookup – Scrape multiple Douyin profiles in a single run.
• User Stats – Extract follower count, following count, total likes received, likes given, and video count.
• Profile Details – Get nickname, username, bio/signature, avatar, cover image, and gender.
• Location Data – Extract IP location (e.g. IP属地：河南), city, province, country, and store region.
• Verification Status – Identify verified accounts, star accounts, and government media VIPs.
• Live Status – Check if the user is currently live streaming.
• Musician Data – Extract original musician info (digg count, music count, music used count).
• Commerce Info – Detect commerce-enabled accounts with shop entries.

---

Use Cases

Use Case	Description	Key Benefits
Influencer Research	Analyze Douyin influencer profiles for marketing campaigns.	Get follower counts, engagement metrics, and verification status.
Competitor Analysis	Monitor competitor Douyin accounts and their growth.	Track followers, video count, and likes over time.
KOL Discovery	Find Key Opinion Leaders on Douyin for brand partnerships.	Identify verified accounts with high engagement.
Market Research	Analyze user profiles in specific regions or niches.	IP location and cross-platform data for market insights.
Social Media Analytics	Build dashboards with Douyin profile data.	Comprehensive stats exported as JSON, CSV, or Excel.
Brand Monitoring	Track brand-related Douyin accounts and their metrics.	Bulk lookup with detailed profile data.

---

Quick Start

1. Basic – Single Profile by sec_user_id

{
  "profiles": ["MS4wLjABAAAAJWCE1eEOJA1Y5I9BbkObqqVz_M1EEAQumOVCMfy8ctw"]
}

2. Basic – Single Profile by URL

{
  "profiles": ["https://www.douyin.com/user/MS4wLjABAAAAJWCE1eEOJA1Y5I9BbkObqqVz_M1EEAQumOVCMfy8ctw"]
}

3. Bulk – Multiple Profiles

{
  "profiles": [
    "MS4wLjABAAAAJWCE1eEOJA1Y5I9BbkObqqVz_M1EEAQumOVCMfy8ctw",
    "https://www.douyin.com/user/MS4wLjABAAAAanotherUserIdHere",
    "MS4wLjABAAAAyetAnotherUserId"
  ]
}

---

Input Parameters

Parameter	Type	Required	Description	Default	Example
profiles	Array of Strings	Yes	One or more Douyin profile URLs or sec_user_id values.	-	["MS4wLjABAAAA..."] or ["https://www.douyin.com/user/MS4wLjABAAAA..."]

Supported Input Formats

Format	Example
sec_user_id (direct)	MS4wLjABAAAAJWCE1eEOJA1Y5I9BbkObqqVz_M1EEAQumOVCMfy8ctw
Douyin profile URL	https://www.douyin.com/user/MS4wLjABAAAA...
Douyin share URL	https://www.iesdouyin.com/share/user/MS4wLjABAAAA...

---

Output Format

Profile Result Data Structure

{
  "source": "douyin_profile",
  "position": 1,

  "uid": "91565952866",
  "sec_uid": "MS4wLjABAAAAJWCE1eEOJA1Y5I9BbkObqqVz_M1EEAQumOVCMfy8ctw",
  "unique_id": "nnvdmdt",
  "short_id": "0",

  "nickname": "十六.",
  "signature": "平安喜樂 如願自在",
  "signature_language": "zh",
  "gender": 0,
  "birthday": "",
  "user_age": -1,

  "avatar_url": "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/...",
  "cover_url": "https://p3-sign.douyinpic.com/obj/douyin-user-image-file/...",
  "profile_cover_url": "https://p3-sign.douyinpic.com/obj/douyin-user-image-file/...",

  "ip_location": "IP属地：河南",
  "city": "",
  "province": "",
  "district": "",
  "country": "",
  "location": "",
  "store_region": "cn-ha",

  "follower_count": 4797,
  "following_count": 49,
  "total_favorited": 29697,
  "favoriting_count": 17420,
  "aweme_count": 73,
  "dongtai_count": 0,
  "max_follower_count": 5594,
  "mplatform_followers_count": 4797,
  "forward_count": 19,
  "public_collects_count": 0,

  "verification_type": 0,
  "custom_verify": "",
  "enterprise_verify_reason": "",
  "is_verified": false,
  "is_star": false,
  "is_ban": false,
  "is_gov_media_vip": false,

  "live_status": 0,
  "room_id": 0,
  "live_commerce": false,
  "with_commerce_entry": false,
  "with_fusion_shop_entry": false,

  "original_musician": {
    "digg_count": 0,
    "music_count": 0,
    "music_used_count": 0
  },

  "cross_platform_followers": [
    { "app_name": "aweme", "name": "抖音", "fans_count": 4797, "icon": "https://..." },
    { "app_name": "news_article", "name": "头条", "fans_count": 0, "icon": "https://..." },
    { "app_name": "live_stream", "name": "抖音火山版", "fans_count": 0, "icon": "https://..." }
  ],

  "share_url": "www.iesdouyin.com/share/user/MS4wLjABAAAA...",

  "scraped_at": "2026-08-05T12:00:00.000Z"
}

Output Fields Explained

Field	Type	Description
source	String	Source indicator, always douyin_profile
position	Integer	Position in the scraper batch (1-based)
uid	String	Douyin internal user ID
sec_uid	String	Secure user ID (used as input identifier)
unique_id	String	Username / handle
short_id	String	Short user ID
nickname	String	Display name
signature	String	Bio / description
signature_language	String	Language code of the bio
gender	Number	0 = unknown, 1 = male, 2 = female
birthday	String	Birthday (if available)
user_age	Number	User age (-1 if not set)
avatar_url	String	Profile picture URL (highest quality)
cover_url	String	Profile cover image URL
profile_cover_url	String	Profile cover from cover_and_head_image_info
ip_location	String	IP-based location (e.g., "IP属地：河南")
city	String	City
province	String	Province
district	String	District
country	String	Country
location	String	Location string (app endpoint)
store_region	String	Store region code (e.g., "cn-ha")
follower_count	Number	Number of followers
following_count	Number	Number of accounts followed
total_favorited	Number	Total likes received on all videos
favoriting_count	Number	Total likes the user has given
aweme_count	Number	Number of published videos
dongtai_count	Number	Number of dynamic posts
max_follower_count	Number	Historical peak follower count
mplatform_followers_count	Number	Multi-platform follower count
forward_count	Number	Number of shares/forwards
public_collects_count	Number	Number of public collections
verification_type	Number	Account verification type (0 = none)
custom_verify	String	Custom verification label
enterprise_verify_reason	String	Enterprise verification reason
is_verified	Boolean	Whether the account is verified
is_star	Boolean	Celebrity/star account
is_ban	Boolean	Whether the account is banned
is_gov_media_vip	Boolean	Government media VIP account
live_status	Number	0 = not live, 1+ = currently live
room_id	Number	Live room ID (if live)
live_commerce	Boolean	Live commerce enabled
with_commerce_entry	Boolean	Has commerce store entry
with_fusion_shop_entry	Boolean	Has fusion shop entry
original_musician	Object	Musician stats (digg_count, music_count, music_used_count)
cross_platform_followers	Array	Follower breakdown across Douyin, Toutiao, Huoshan
share_url	String	Profile share URL
scraped_at	String	ISO timestamp of when the data was extracted

---

Performance & Limits

• Bulk Lookups – Scrape hundreds of Douyin profiles in a single run.
• Batching – Data is saved in batches of 10 items to prevent loss during unexpected errors.
• Rate Limiting – Built-in 1.5-second delay between profile requests for optimal throughput.
• Key Rotation – Automatic key rotation and retry logic for smooth, uninterrupted performance.
• Deduplication – Duplicate profile inputs are automatically removed before processing.

---

FAQ

• Q: Where do I find sec_user_id?
  • You can find the sec_user_id in any Douyin profile URL. It's the string after /user/ in the URL (e.g., https://www.douyin.com/user/MS4wLjABAAAA...). You can also paste the full URL directly.
• Q: Can I use profile URLs instead of sec_user_id?
  • Yes! The actor automatically extracts sec_user_id from Douyin profile URLs (douyin.com/user/...) and share URLs (iesdouyin.com/share/user/...).
• Q: Can I look up multiple profiles at once?
  • Yes! Simply add multiple profile URLs or sec_user_ids to the profiles array. Each one will be queried individually with automatic rate limiting.
• Q: What if a profile doesn't exist?
  • Invalid profiles will return an error record with details. The scraper will continue processing remaining profiles.
• Q: What does gender = 0 mean?
  • Gender values: 0 = not set/unknown, 1 = male, 2 = female.
• Q: What is ip_location?
  • The ip_location field shows the user's IP-based location as displayed on Douyin (e.g., "IP属地：河南" means "IP Location: Henan").
• Q: What data formats can I export?
  • Apify supports exporting results as JSON, CSV, Excel (XLSX), XML, HTML, and RSS.
• Q: What is cross_platform_followers?
  • This shows the user's follower count across ByteDance platforms: Douyin (抖音), Toutiao (头条), and Huoshan/Douyin Volcano (抖音火山版).

---

Troubleshooting

Issue	Cause	Solution
"No profiles provided"	Empty or missing profiles array	Enter at least one profile URL or sec_user_id
Profile not found	Invalid or outdated sec_user_id	Verify the profile exists on Douyin
Both endpoints failed	Network issues or API downtime	Wait a few minutes and try again
Rate limit exceeded	Too many concurrent requests	Wait a few minutes and try again
Partial results	Some profiles failed while others succeeded	Check error records in the output for details
Missing cross_platform_followers	App endpoint didn't return this data	This is normal for some profiles

---

Why Choose This Actor?

• Comprehensive Douyin user profile data
• Follower, following, likes, and video counts
• IP location and regional data
• Verification and celebrity status
• Live streaming status detection
• Cross-platform follower breakdown (Douyin, Toutiao, Huoshan)
• Original musician info
• Commerce and shop detection
• Bulk profile lookup support
• Downloadable as CSV, Excel, JSON, XML, or HTML

---

Tags

douyin scraper, douyin profile data, chinese tiktok scraper, douyin user scraper, douyin follower count, douyin analytics, social media scraper, douyin api, tiktok china scraper, influencer research, kol discovery, douyin data extraction, apify actor

---

Get Started Now

1. Enter one or more Douyin profile URLs or sec_user_id values
2. Click Start to run the scraper
3. Export your data in JSON, CSV, or Excel format
4. Click "Try for free" to test the actor

---

Built using Apify Platform | Optimized for Performance & Reliability