🎬 TikTok User Video Scraper - Extract & Analyze TikTok Videos

Extract videos from any TikTok user profile with comprehensive metadata, engagement metrics, and download URLs. Get detailed video data including views, likes, comments, shares, music info, and more. Perfect for content analysis, trend research, competitor monitoring, and video archiving!

---

📋 Table of Contents

• 🚀 Overview
• ✨ Key Features
• 🎯 Use Cases
• ⚡ Quick Start
• 📊 Input Parameters
• 📤 Output Format
• 📈 Data Fields Explained
• 🌟 Performance �26 Reliability
• 💡 Best Practices
• ❓ FAQ
• 🛠️ Troubleshooting
• 🏷️ SEO Keywords

---

🚀 Overview

This Apify actor scrapes videos from TikTok user profiles.

• ✅ Input: TikTok usernames (without @)
• ✅ Output: One dataset item per video
• ✅ Use directly from the Apify Console, via API, or in integrations (Make, Zapier, custom scripts, etc.)

You do not need a TikTok account or login. The actor works with publicly available TikTok data.

---

✨ Key Features

• 🎬 User Video Scraping – Get videos for any public TikTok username
• 📊 Rich Metadata – Title, region, duration, covers, images (for photo posts)
• 📈 Engagement Metrics – Views, likes, comments, shares, saves, downloads
• 🎵 Music Information – Track name, artist, album, duration
• 👤 Author Details – Username, nickname, avatar
• 🌍 Multiple Profiles – Scrape many usernames in a single run
• 🗂️ Clean Dataset – Export to JSON, CSV, Excel.

---

🎯 Use Cases

Use Case	Description	Benefits
📹 Content Analysis	Analyze videos from specific creators or brands	Understand what type of content performs best
🧠 Trend Research	Track formats, effects, and music that get high engagement	Spot trends early and adapt your strategy
🏆 Competitor Monitoring	Watch competitor accounts and their latest posts	Learn what works for others in your niche
📂 Video Archiving	Collect video metadata and URLs for backup or research	Keep a structured archive of content
📊 Reporting & Dashboards	Feed data into BI tools or dashboards	Create performance reports over time
🎓 Academic / Data Research	Study TikTok behavior, formats, or virality	Work with structured, machine-readable data

---

⚡ Quick Start

1️⃣ Minimal Example

{
  "usernames": ["khaby.lame"],
  "maxVideos": 5
}

2️⃣ Multiple Users in One Run

{
  "usernames": ["khaby.lame", "bellapoarch"],
  "maxVideos": 10
}

3️⃣ Deep Scrape for One Profile

{
  "usernames": ["charlidamelio"],
  "maxVideos": 100
}

---

📊 Input Parameters

Configuration Table

Parameter	Type	Required	Default	Range	Description
usernames	Array of strings	✅	–	1–50	TikTok usernames (without @) whose videos you want to scrape
maxVideos	Integer	❌	10	1–100	Maximum number of videos to scrape per username

Details

usernames

• Enter plain TikTok usernames like "khaby.lame", "charlidamelio"
• Do not include the @ symbol
• Duplicates are automatically removed
• You can combine multiple usernames in a single run

maxVideos

• Controls how many latest videos you want per user
• Higher values = more data, but longer run time
• Recommended: 10–50 for most practical use cases

---

📤 Output Format

Each item in the dataset represents one TikTok video from a user profile.

Example Item

{
  "source": "tiktok",
  "username": "charlidamelio",
  "aweme_id": "v12044gd0000d4f62tfog65rmh1u8c20",
  "video_id": "7574599985963011341",
  "region": "US",
  "title": "happy place @Prada",
  "cover": "https://.../cover.jpeg",
  "ai_dynamic_cover": "https://.../dynamic.jpeg",
  "origin_cover": "https://.../origin.webp",
  "duration": 32,
  "play_url": "https://.../video.mp4",
  "wmplay_url": "https://.../video_watermark.mp4",
  "size": 3142484,
  "wm_size": 3215548,
  "music_url": "https://.../music.mp3",
  "play_count": 1866045,
  "digg_count": 54619,
  "comment_count": 1198,
  "share_count": 1179,
  "download_count": 436,
  "collect_count": 2028,
  "create_time": 1763599023,
  "is_ad": false,
  "is_top": 0,
  "music_info": {
    "id": "7268337112642193410",
    "title": "Fashion Show",
    "play": "https://.../music.mp3",
    "cover": "https://.../music_cover.jpeg",
    "author": "Beatdohostil",
    "original": false,
    "duration": 152,
    "album": "Trilha de Desfile"
  },
  "author": {
    "id": "5831967",
    "unique_id": "charlidamelio",
    "nickname": "charli d�27amelio",
    "avatar": "https://.../avatar.jpeg"
  }
}

You can export this dataset from Apify as JSON, CSV, XLSX, XML, or HTML.

---

📈 Data Fields Explained

Main Field Groups

Group	Example Fields	Description
🔹 Basic Video	aweme_id, video_id, title, region, duration	Core identification and descriptive info
🖼️ Media	cover, ai_dynamic_cover, origin_cover, images	Thumbnails and images related to the video or photo post
🎬 Playback	play_url, wmplay_url, size, wm_size	URLs and sizes for playing or downloading
📊 Engagement	play_count, digg_count, comment_count, share_count, download_count, collect_count	How the video performs on TikTok
🎵 Music	music_url, music_info.*	Track used in the video
👤 Author	username, author.unique_id, author.nickname, author.avatar	Info about the profile that posted the video

Notes

• play_url usually points to a non‑watermarked or standard playback URL
• wmplay_url is typically a watermarked playback URL
• images is present for photo posts instead of classic videos

---

🌟 Performance & Reliability

Aspect	Details
⏱️ Typical run time	A few seconds to a few minutes, depending on usernames and maxVideos
📦 Data volume	Up to usernames * maxVideos items
🔁 Retries	Built‑in retry logic for temporary issues
🧱 Error handling	Invalid usernames are logged and skipped gracefully

The actor is designed to run reliably on the Apify platform with smart delays and rotation.

---

💡 Best Practices

1. Start small – Test with 1–2 usernames and maxVideos = 5–10.
2. Use clean usernames – Only letters, numbers, dots, and underscores. Avoid spaces or special characters.
3. Increase gradually – Once everything looks good, increase maxVideos for deeper analysis.
4. Export to your tools – Use Apify's export functionality to move data into your own systems (BI tools, databases, dashboards).
5. Schedule runs – Use Apify schedules to track new videos over time.

---

❓ FAQ

Q1: Do I need a TikTok account or login?

A: No. The actor works with publicly available TikTok profile data and does not require login.

Q2: What happens if I enter an invalid username?

A: The run will continue, but that username will produce 0 videos. In the logs you will see a message that the username may be invalid or no valid data was returned.

Q3: Can I scrape private accounts?

A: No. Only content that is publicly accessible on TikTok can be scraped.

Q4: How many videos can I scrape per user?

A: You can set maxVideos between 1 and 100. Higher values increase run time and data volume.

Q5: In which formats can I export the data?

A: From the Apify dataset you can export to JSON, CSV, Excel, XML, and HTML.

Q6: Can I use this actor via API?

A: Yes. Every Apify actor can be started via HTTP API. Use the same input JSON structure as shown in the Quick Start section.

Q7: Is this actor only for one‑time runs?

A: You can use it for one‑time analysis or schedule it on Apify to run periodically and track new uploads over time.

---

🛠️ Troubleshooting

Issue	Possible Cause	Suggested Fix
Run finished but dataset is empty	Invalid usernames, private profiles, or maxVideos very low	Test with a known public account like "khaby.lame" and maxVideos: 5
"Username may be invalid" in logs	Typo, unsupported characters, or non‑existent account	Remove special characters, check spelling, try the profile directly on TikTok
Very slow runs	Too many usernames or very high maxVideos	Reduce maxVideos or split usernames into multiple runs
Occasional network errors	Temporary connection or upstream issues	Re‑run the actor or enable retries in your automation

---

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

---

🏷️ Find Me Tags

TikTok user video scraper, TikTok profile video scraper, TikTok user videos extractor, TikTok video metadata, TikTok video analytics, TikTok content analysis, TikTok competitor monitoring, TikTok video downloader dataset, TikTok user feed scraper, TikTok user posts scraper, TikTok video engagement metrics, TikTok video data export, TikTok video research tool, TikTok profile analysis, TikTok video archiving, Apify TikTok scraper, TikTok automation, TikTok data collection, TikTok social media analytics, TikTok Photo Downloader, TikTok Photo Gallery Downloader, TikTok Post Image Downloader, TikTok Image Scraper.

---

🚀 Get Started Now

Ready to discover TikTok creators and influencers?

1. Click "Try for free" to test the actor
2. Enter your search keywords
3. Get comprehensive TikTok user data instantly
4. Export results in your preferred format (JSON, CSV, Excel)
5. Use the related actors for additional functionality

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