TikTok Video Data Extractor & Metadata Scraper

Extract comprehensive video metadata, engagement analytics, author profiles, and direct media URLs from TikTok videos in bulk. This high-performance scraper delivers rich, deeply nested platform data structures instantly.

What does this actor do?

This actor takes a list of TikTok video URLs and extracts complete, unflattened video data including:

• Video metadata (ID, title, duration, region)
• Direct media URLs (play, wmplay, hdplay streams)
• Engagement metrics (views, likes, comments, shares)
• Audio/music information (track details, artist, album)
• Author profiles (ID, username, nickname)
• Creation timestamps and processing times

Why use this actor?

• Deep Nested Data Structure: Preserves authentic, multi-layered platform schema for maximum data fidelity
• True Bulk Processing: Process hundreds of video links at once with zero structural bottlenecking
• Direct HD Media Links: Extract both watermarked and non-watermarked high-definition playback streams
• Complete Audio Profiling: Get full background track identities, artist tags, albums, and audio stream URLs
• Fast & Reliable: High-performance API-based extraction with minimal latency

Input

Parameter	Type	Required	Description
urls	Array of strings	Yes	Array of TikTok video URLs to process

Input Example

{
  "urls": [
    "https://www.tiktok.com/@billieeilish/video/7050551461734042926"
  ]
}

Output

Each processed video returns a complete data object with the following structure:

Field	Type	Description
inputUrl	String	The exact TikTok URL requested
code	Number	Response status code (0 = success)
msg	String	Response message
processed_time	Number	Time taken to process the request (seconds)
data	Object	Complete video data object

Output Example

[
  {
    "inputUrl": "https://www.tiktok.com/@billieeilish/video/7050551461734042926",
    "code": 0,
    "msg": "success",
    "processed_time": 0.8612,
    "data": {
      "id": "7050551461734042926",
      "region": "US",
      "title": "can't be good at everything",
      "duration": 29,
      "play": "https://v16m.tiktokcdn-us.com/...",
      "wmplay": "https://v16m.tiktokcdn-us.com/...",
      "hdplay": "https://v16.tokcdn.com/...",
      "size": 2327756,
      "wm_size": 2356556,
      "hd_size": 10829374,
      "music_info": {
        "id": "6929763762322343937",
        "title": "These Days",
        "author": "Nico",
        "album": "Chelsea Girl"
      },
      "play_count": 204139265,
      "digg_count": 27640097,
      "comment_count": 198682,
      "share_count": 69286,
      "download_count": 123673,
      "collect_count": 477433,
      "create_time": 1641584436,
      "author": {
        "id": "6879693940111901701",
        "unique_id": "billieeilish",
        "nickname": "BILLIE EILISH"
      }
    }
  }
]

Important Notes

• This scraper requires a valid TIKWM_API_KEY environment variable
• Only publicly available TikTok video data is extracted
• Processing includes a 1-second delay between requests for rate limiting
• Failed requests are logged but do not stop the entire batch process

Legal & Compliance

This actor only collects public data points explicitly made available by platform accounts. Data extraction practices conform to global digital compliance standards. Please verify local compliance expectations (such as GDPR or CCPA) if your processing routines capture identifiable creator profiles.