📹 TikTok Video List Scraper

Scrape video lists from TikTok user profiles. Collects comprehensive metadata for each video including description, view counts, likes, comments, shares, duration, thumbnail, music info, and more.

✨ Features

• User Profile Scraping — Provide TikTok profile URLs to collect all published videos
• Comprehensive Metadata — View count, likes, comments, shares, saves, duration, creation time
• Music & Author Info — Track title, artist name, author username and ID
• Pagination Support — Automatically paginates through all user videos
• Configurable Limits — Set max results per profile (or unlimited)
• No Proxy Needed — Works from datacenter IPs without residential proxies

🔧 How It Works

1. Fetches the TikTok user profile page to extract the user's secUid
2. Calls TikTok's internal API to retrieve the video list with cursor-based pagination
3. Extracts and normalizes video metadata into a flat, clean structure
4. Pushes results to the Apify dataset sorted by creation time (newest first)

📥 Input

Field	Type	Description
profiles	Array of URLs	TikTok user profile URLs (e.g., https://www.tiktok.com/@username)
max_results	Integer	Maximum videos per profile. 0 = unlimited. Default: 50
request_timeout	Integer	HTTP timeout in seconds. Default: 30

📤 Sample Output

{
    "id": "7613428831285808402",
    "desc": "Cat does something adorable 🐱",
    "createTime": "2025-09-15T08:30:00Z",
    "createTimestamp": 1726389000,
    "duration": 15,
    "playCount": 1250000,
    "diggCount": 98000,
    "commentCount": 1200,
    "shareCount": 5600,
    "collectCount": 3400,
    "thumbnail": "https://p16-sign-sg.tiktokcdn.com/...",
    "webpage_url": "https://www.tiktok.com/@meowtakeover/video/7613428831285808402",
    "music": {
        "title": "Original Sound",
        "authorName": "meowtakeover"
    },
    "author": {
        "uniqueId": "meowtakeover",
        "id": "123456789",
        "secUid": "MS4wLjAB..."
    },
    "fetched_at": "2026-03-22T12:00:00Z"
}

⚠️ Notes

• Rate Limiting: The Actor includes built-in delays between requests to avoid being rate-limited by TikTok
• Private Profiles: Only public profiles can be scraped. Private accounts will return no results
• Memory: 256 MB is sufficient for most use cases. Increase to 512 MB for very large profiles (10,000+ videos)
• Video Content: This Actor collects video metadata (not the actual video files). For downloading videos, use our TikTok Videos Watermark-Free Scraper