---

TikTok Video Scraper & Downloader - Enterprise-Grade Media Acquisition Tool

Professional solution for downloading TikTok videos with exhaustive metadata, multiple format options, and high-fidelity asset extraction.

---

Overview

The TikTok Video Scraper & Downloader is a powerful automation tool engineered for professionals and businesses that require reliable, high-quality TikTok video content acquisition. This actor processes TikTok URLs to deliver videos in various encodings and resolutions, complete with extensive technical metadata and multiple thumbnail assets.

Core Capabilities

• Multi-format video downloads with support for both H.264 and modern H.265 (HEVC) codecs.
• Comprehensive metadata extraction including video ID, description, creator info, and precise duration.
• Multiple thumbnail assets including dynamic covers, static covers, and origin covers.
• Intelligent quality selection with automatically identified "best format" for optimal balance of size and quality.
• Technical format analysis with detailed codec, bitrate, resolution, and filesize information.

---

Input Configuration

{
  "video_urls": [
    {
      "url": "https://www.tiktok.com/@scout2015/video/6718335390845095173",
      "method": "GET"
    }
  ]
}

Input Specifications

Parameter	Type	Required	Description
video_urls	Array	Yes	Array of TikTok video objects to process.
url	String	Yes	A valid TikTok video URL (must be in the format www.tiktok.com/@username/video/videoID).
method	String	Yes	HTTP method for the request (GET is standard and recommended).

---

Output Structure

[
  {
    "source_url": "https://www.tiktok.com/@scout2015/video/6718335390845095173",
    "metadata": {
      "id": "6718335390845095173",
      "title": "Scramble up ur name & I’ll try to guess it😍❤️ #foryoupage #petsoftikt...",
      "webpage_url": "https://www.tiktok.com/@scout2015/video/6718335390845095173",
      "duration": 10,
      "uploader": "scout2015",
      "thumbnail": "https://api.apify.com/v2/key-value-stores/Z2Irgp9Luuap4aaGX/records/6718335390845095173_thumbnail.jpg?token=apify_actor_run_api_AmPXfo17grbPNAFf0YuSQaoPfh24L013IUEf",
      "extractor": "TikTok",
      "direct_url": "https://api.apify.com/v2/key-value-stores/Z2Irgp9Luuap4aaGX/records/6718335390845095173_h264_540p_2240963-0.mp4?token=apify_actor_run_api_AmPXfo17grbPNAFf0YuSQaoPfh24L013IUEf"
    },
    "formats": [
      {
        "ext": "mp4",
        "vcodec": "h265",
        "acodec": "aac",
        "format_id": "bytevc1_720p_1504834-0",
        "tbr": 1504,
        "quality": 2,
        "format_note": null,
        "preference": -1,
        "filesize": 2004627,
        "width": 720,
        "height": 1280,
        "url": "https://api.apify.com/v2/key-value-stores/Z2Irgp9Luuap4aaGX/records/6718335390845095173_bytevc1_720p_1504834-0.mp4?token=apify_actor_run_api_AmPXfo17grbPNAFf0YuSQaoPfh24L013IUEf",
        "protocol": "https",
        "video_ext": "mp4",
        "audio_ext": "none",
        "vbr": null,
        "abr": null,
        "resolution": "720x1280",
        "dynamic_range": "SDR",
        "aspect_ratio": 0.56,
        "format": "bytevc1_720p_1504834-0 - 720x1280"
      },
      {
        "ext": "mp4",
        "vcodec": "h264",
        "acodec": "aac",
        "format_id": "h264_540p_2240963-0",
        "tbr": 2240,
        "quality": 1,
        "format_note": null,
        "preference": -1,
        "filesize": 2953029,
        "width": 576,
        "height": 1024,
        "url": "https://api.apify.com/v2/key-value-stores/Z2Irgp9Luuap4aaGX/records/6718335390845095173_h264_540p_2240963-0.mp4?token=apify_actor_run_api_AmPXfo17grbPNAFf0YuSQaoPfh24L013IUEf",
        "protocol": "https",
        "video_ext": "mp4",
        "audio_ext": "none",
        "vbr": null,
        "abr": null,
        "resolution": "576x1024",
        "dynamic_range": "SDR",
        "aspect_ratio": 0.56,
        "format": "h264_540p_2240963-0 - 576x1024"
      }
    ],
    "best_format": {
      "ext": "mp4",
      "vcodec": "h265",
      "acodec": "aac",
      "format_id": "bytevc1_720p_1504834-0",
      "tbr": 1504,
      "quality": 2,
      "format_note": null,
      "preference": -1,
      "filesize": 2004627,
      "width": 720,
      "height": 1280,
      "url": "https://api.apify.com/v2/key-value-stores/Z2Irgp9Luuap4aaGX/records/6718335390845095173_bytevc1_720p_1504834-0.mp4?token=apify_actor_run_api_AmPXfo17grbPNAFf0YuSQaoPfh24L013IUEf",
      "protocol": "https",
      "video_ext": "mp4",
      "audio_ext": "none",
      "vbr": null,
      "abr": null,
      "resolution": "720x1280",
      "dynamic_range": "SDR",
      "aspect_ratio": 0.56,
      "format": "bytevc1_720p_1504834-0 - 720x1280"
    },
    "thumbnails": [
      {
        "id": "dynamicCover",
        "url": "https://api.apify.com/v2/key-value-stores/Z2Irgp9Luuap4aaGX/records/6718335390845095173_thumbnail_0.webp?token=apify_actor_run_api_AmPXfo17grbPNAFf0YuSQaoPfh24L013IUEf",
        "preference": -2
      },
      {
        "id": "cover",
        "url": "https://api.apify.com/v2/key-value-stores/Z2Irgp9Luuap4aaGX/records/6718335390845095173_thumbnail_1.jpg?token=apify_actor_run_api_AmPXfo17grbPNAFf0YuSQaoPfh24L013IUEf",
        "preference": -1
      },
      {
        "id": "originCover",
        "url": "https://api.apify.com/v2/key-value-stores/Z2Irgp9Luuap4aaGX/records/6718335390845095173_thumbnail_2.jpg?token=apify_actor_run_api_AmPXfo17grbPNAFf0YuSQaoPfh24L013IUEf",
        "preference": -1
      }
    ]
  }
]

Output Field Documentation

Top-Level Object

Field	Description
source_url	The original TikTok URL that was processed.
metadata	An object containing all extracted information about the video.
formats	An array of all available video/audio format variants.
best_format	An object representing the format automatically selected as the best quality-to-size ratio.
thumbnails	An array of available thumbnail images in different styles.

Metadata Section

Field	Description
id	The unique TikTok video ID.
title	The full description/text of the TikTok video.
webpage_url	The canonical URL for the video.
duration	The length of the video in seconds.
uploader	The TikTok username of the content creator.
thumbnail	URL to the primary thumbnail image.
extractor	Source identifier (always "TikTok").
direct_url	A direct download URL for a default video format.

Format Object (within formats and best_format)

Field	Description
ext	File container extension (e.g., mp4).
vcodec	Video codec (e.g., h264, h265/bytevc1).
acodec	Audio codec (e.g., aac).
format_id	Unique identifier for this specific format.
width	Video width in pixels.
height	Video height in pixels.
resolution	Formatted resolution string (e.g., 720x1280).
filesize	Size of the file in bytes.
tbr	Average total bitrate in Kbps.
url	The direct download URL for this specific format.
aspect_ratio	The computed width-to-height ratio.
dynamic_range	The video's dynamic range (typically SDR).

Thumbnails Array

Field	Description
id	Type of thumbnail (dynamicCover, cover, originCover).
url	The direct download URL for the thumbnail image.
preference	Indicator for sorting priority.

---

Available Formats & Quality Tiers

The actor automatically extracts every available format, providing unparalleled choice:

1. H.265 (HEVC) - High Efficiency: Modern codec offering superior compression (e.g., 720p at a smaller filesize).
2. H.264 - High Compatibility: Universal codec ensures playback on any device (e.g., 540p).
3. Variable Resolutions: Typically includes portrait-oriented resolutions like 720x1280 and 576x1024.

The best_format field is automatically selected to provide the ideal balance of high resolution and efficient file size, typically favoring the H.265 variant.

---

Technical Features

Advanced Media Handling

• Dual Codec Support: Extraction of both H.264 and H.265 (HEVC) encoded streams.
• Complete Asset Package: Downloads video, audio, and multiple styles of thumbnails in a single request.
• Smart Quality Selection: Automatic identification of the "best" format based on codec efficiency and resolution.

Comprehensive Metadata

• Full Video Description: Extraction of the complete video title/text, including hashtags.
• Creator Attribution: Accurate capture of the uploader's TikTok handle.
• Technical Specifications: Detailed bitrate, codec, filesize, and resolution data for every format.

Enterprise-Grade Reliability

• Robust Parsing: Built to handle changes in TikTok's structure for maximum uptime.
• Direct Download Links: Provides signed URLs for reliable, fast downloading of assets.
• Structured Data Output: Consistent, predictable JSON output for easy integration into pipelines.

---

Enterprise Applications

Digital Marketing Agencies

• Campiment Archival: Securely archive client campaign videos for reporting and compliance.
• Competitive Analysis: Download and analyze competitor content and engagement strategies.
• Content Sourcing: Source high-performing TikTok trends for inspiration and repurposing.

Content Creation & Editing Studios

• High-Quality Sources: Acquire videos in the best available quality for professional editing and compilation.
• Multi-Format Workflows: Choose the optimal format (H.265 for size, H.264 for compatibility) for different projects.
• Asset Libraries: Build a library of thumbnails and videos for mock-ups and presentations.

Research and Analysis Firms

• Trend Analysis: Collect large datasets of TikTok videos to study virality, trends, and user behavior.
• Metadata Studies: Analyze metadata patterns, video durations, and common formats across the platform.

Software Development Teams

• API Alternative: Use as a reliable, scalable backend for applications that need TikTok integration, bypassing official API limitations.
• Content Aggregation: Power platforms that aggregate social media content from multiple sources.
• Moderation Tools: Feed video content into automated moderation and content analysis systems.