Pricing

Rating

Developer

Actor stats

Categories

Share

👤 TikTok Profile Details Scraper - Complete Profile Data Extraction

Extract comprehensive TikTok Profile details by username in seconds. Get complete profile information, statistics, verification status, social media links, and engagement metrics. Perfect for influencer research, profile analysis, competitor tracking, and data collection!

📋 Table of Contents

• 🚀 Features
• 🎯 Use Cases
• ⚡ Quick Start
• 📊 Input Parameters
• 📤 Output Format
• 📈 Data Fields Explained
• 💡 Best Practices
• 🌟 Performance & Reliability
• ❓ FAQ
• 🛠️ Troubleshooting
• 📞 Support

🚀 Features

👤 Complete User Profile Extraction

• ✅ Username Lookup - Fetch user details by TikTok username (unique_id)
• ✅ Batch Processing - Process up to 100 usernames in a single run
• ✅ Real-Time Data - Get the latest user information instantly
• ✅ Flexible Input - Support for single or multiple usernames
• ✅ Auto-Deduplication - Automatically removes duplicate usernames

📊 Comprehensive Profile Data

• ✅ Basic Information - User ID, username, display name, bio, and avatars
• ✅ Verification Status - Identify verified accounts with blue checkmarks
• ✅ Account Settings - Privacy status, FTC compliance, age restrictions
• ✅ Social Media Links - Instagram, Twitter, YouTube channel connections
• ✅ Bio Links - External links from user profiles
• ✅ Account Creation Date - When the account was created

📈 Detailed Statistics

• ✅ Follower Count - Total number of followers
• ✅ Following Count - Number of accounts followed
• ✅ Video Count - Total videos posted
• ✅ Heart Count - Total likes received across all videos
• ✅ Digg Count - Total videos liked by the user
• ✅ Optional Stats - Toggle statistics on/off based on your needs

🎯 Use Cases

⚡ Quick Start

1️⃣ Single User Lookup

{
"usernames":["tiktok"]
}

2️⃣ Multiple Users with Statistics

{
"usernames":["charlidamelio","khaby.lame","bellapoarch"],
"includeStats":true
}

3️⃣ Batch Profile Extraction

{
"usernames":[
"tiktok",
"charlidamelio",
"addisonre",
"zachking",
"lorengray"
],
"includeStats":true
}

4️⃣ Profile Only (No Statistics)

{
"usernames":["tiktok"],
"includeStats":false
}

📊 Input Parameters

Configuration Options

📝 Parameter Details

usernames

• Array of TikTok usernames (unique_id) to extract details for
• Enter usernames without the @ symbol
• Examples: ["tiktok"], ["charlidamelio", "khaby.lame"]
• Supports 1-100 usernames per run
• Automatically removes duplicate usernames
• Case-sensitive (use exact username as shown on TikTok)

includeStats

• Boolean flag to include or exclude user statistics
• When true: Includes followers, following, videos, hearts, and diggs
• When false: Returns only basic profile information
• Default: true
• Recommended: Keep true for comprehensive data

📤 Output Format

Complete TikTok User Profile Data

{
"source":"tiktok",
"scraped_at":"2024-11-27T09:42:15.123Z",
"user_id":"107955",
"unique_id":"tiktok",
"nickname":"TikTok",
"avatar_thumb":"https://p16-sign-va.tiktokcdn.com/...",
"avatar_medium":"https://p16-sign-va.tiktokcdn.com/...",
"avatar_larger":"https://p16-sign-va.tiktokcdn.com/...",
"signature":"One TikTok can make a big impact",
"verified":true,
"sec_uid":"MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
"secret":false,
"ftc":false,
"relation":0,
"open_favorite":false,
"comment_setting":null,
"duet_setting":null,
"stitch_setting":null,
"private_account":false,
"is_ad_virtual":false,
"is_under_age_18":false,
"ins_id":"",
"twitter_id":"",
"youtube_channel_title":"",
"youtube_channel_id":"",
"user_story_status":0,
"create_time":1425144149,
"bio_link":"linktr.ee/tiktok",
"stats":{
"following_count":1,
"follower_count":91845112,
"heart_count":450333284,
"video_count":1379,
"digg_count":0
}
}

📈 Data Fields Explained

📊 Field Categories

📝 Detailed Field Descriptions

Profile Fields:

• user_id: Unique numeric TikTok user identifier
• unique_id: TikTok username/handle (e.g., "tiktok", "charlidamelio")
• nickname: Display name shown on profile
• signature: User bio/description text
• bio_link: External link in bio (e.g., Linktree, personal website)
• verified: Boolean indicating verified account status (✅ blue checkmark)
• private_account: Boolean indicating if account is private
• secret: Boolean indicating if account is secret/hidden
• ftc: Boolean indicating FTC compliance status

Statistics Fields (when includeStats = true):

• follower_count: Total number of followers
• following_count: Total number of accounts followed
• video_count: Total number of videos posted
• heart_count: Total hearts/likes received across all videos
• digg_count: Total number of videos liked by the user

Avatar URLs:

• avatar_thumb: Small thumbnail (100x100 pixels)
• avatar_medium: Medium size (720x720 pixels)
• avatar_larger: Large high-quality (1080x1080 pixels)

Social Media Links:

• ins_id: Connected Instagram username
• twitter_id: Connected Twitter username
• youtube_channel_title: YouTube channel name
• youtube_channel_id: YouTube channel ID

Account Settings:

• comment_setting: Comment permissions (0 = everyone, 1 = friends, 2 = off)
• duet_setting: Duet permissions (0 = everyone, 1 = friends, 2 = off)
• stitch_setting: Stitch permissions (0 = everyone, 1 = friends, 2 = off)
• open_favorite: Boolean indicating if favorites are public

Timestamps:

• create_time: Unix timestamp of account creation
• scraped_at: ISO 8601 timestamp of data extraction

💡 Best Practices

✅ Recommended Usage

1. Use Exact Usernames - Enter usernames exactly as they appear on TikTok (case-sensitive)
2. Batch Processing - Process multiple usernames in one run for efficiency
3. Include Statistics - Keep includeStats: true for comprehensive data
4. Regular Monitoring - Schedule periodic runs to track profile changes over time
5. Data Validation - Verify usernames exist before processing large batches
6. Export Formats - Use JSON for APIs, CSV/Excel for spreadsheet analysis

⚠️ Important Notes

• Usernames are case-sensitive - use exact spelling
• Don't include the @ symbol in usernames
• Private accounts return profile data but limited content access
• Deleted/suspended accounts will return 404 errors
• Statistics are real-time at the moment of scraping
• Social links may be empty if user hasn't connected accounts
• Bio links require user to add them in their profile

🌟 Performance & Reliability

⚡ Speed & Efficiency

🔄 Reliability Features

• ✅ Auto-Retry Logic - Handles temporary failures with exponential backoff
• ✅ Error Recovery - Comprehensive error handling and graceful degradation
• ✅ Rate Limit Protection - Smart throttling with delays between requests
• ✅ Data Validation - Ensures output quality and completeness
• ✅ Duplicate Prevention - Automatic deduplication of usernames

❓ FAQ

Q: Do I need a TikTok account to use this actor?

A: No! This actor works without requiring any TikTok login or authentication. It accesses publicly available user profile data.

Q: How do I find a user's TikTok username?

A: The username (unique_id) is shown in the TikTok profile URL: tiktok.com/@username. Use the part after the @ symbol without including the @ itself.

Q: What's the difference between unique_id and nickname?

A: unique_id is the TikTok username/handle (e.g., "charlidamelio"), while nickname is the display name shown on the profile (e.g., "charli d'amelio").

Q: How accurate are the follower counts and statistics?

A: All statistics are accurate at the exact moment of scraping. TikTok updates these in real-time, so numbers may change quickly for active accounts.

Q: What happens if a username doesn't exist?

A: The actor will log a "User not found" message for that username and continue processing other usernames. Failed usernames won't appear in the output.

Q: How many usernames can I process at once?

A: You can process up to 100 usernames in a single run. For larger batches, split them across multiple runs.

Q: Can I get data from private accounts?

A: Yes! The actor returns profile information for private accounts, including bio, avatar, and statistics. However, you won't be able to access their videos without following them.

Q: What are the social media link fields for?

A: If a TikTok user has connected their Instagram, Twitter, or YouTube accounts, those usernames/IDs will appear in the respective fields (ins_id, twitter_id, youtube_channel_title).

Q: Can I export the data to CSV or Excel?

A: Yes! Apify allows you to export results in multiple formats including JSON, CSV, Excel, HTML, and XML.

Q: How often can I run this actor?

A: You can run it as often as needed. The actor includes rate limit protection and retry logic for reliable operation.

Q: What does the create_time field represent?

A: It's a Unix timestamp indicating when the TikTok account was created. Convert it to a readable date using online converters or programming libraries.

Q: Is this legal and compliant?

A: This actor accesses publicly available TikTok profile data. Users must comply with TikTok's Terms of Service and applicable laws. Use responsibly and ethically.

📞 Support

🆘 Need Help?

• 📧 Issues - Report bugs and request features
• 🎯 Best Practices - Follow the recommendations above for optimal results

Related Actors 🤝

Looking for more TikTok data extraction tools? Check out these related actors:

• TikTok Trending Videos Scraper
• TikTok Media Downloader
• TikTok Comments Scraper
• TikTok Search Videos Scraper
• TikTok Search Profile Scraper
• TikTok Profile Details Scraper

🏷️ Find Me Tags

tiktok user details, tiktok profile scraper, tiktok user info, tiktok account data, tiktok user extractor, tiktok profile data, tiktok user statistics, tiktok follower count, tiktok influencer data, tiktok creator profiles, tiktok user analytics, tiktok profile information, tiktok account scraper, tiktok user lookup, tiktok username search, tiktok profile extractor, tiktok user api, tiktok data extraction, tiktok scraper apify, tiktok user database, tiktok influencer research, tiktok competitor analysis, tiktok profile analytics, tiktok account information, tiktok user metrics, tiktok social media data, tiktok verification status, tiktok bio scraper, tiktok avatar extractor, tiktok engagement metrics, tiktok creator analytics, tiktok influencer marketing, tiktok data collection, tiktok profile monitoring, tiktok user tracking, tiktok account analysis, tiktok social links, tiktok cross-platform data, tiktok user research, tiktok profile api

🚀 Get Started Now

Ready to extract TikTok user details?

1. Click "Try for free" to test the actor
2. Enter TikTok usernames you want to analyze
3. Choose whether to include statistics
4. Run the actor and get comprehensive profile data
5. Export results in JSON, CSV, or Excel format

⭐ If this actor helps your workflow, please give it a star!

Built with ❤️ using Apify Platform | TikTok Profile Details Scraper v1.0