---

TikTok Video Downloader - Professional Media Extraction Tool

Enterprise-grade solution for downloading TikTok videos with multiple quality options, comprehensive metadata, and direct access to high-fidelity media assets.

---

Overview

The TikTok Video Downloader is a sophisticated automation tool designed for professionals who require high-quality TikTok content with complete technical metadata. This actor extracts videos from provided URLs while delivering multiple resolution options, detailed creator information, and direct access to media assets for seamless integration into professional workflows.

Core Capabilities

• Multi-quality video downloads with resolution options up to 720x1280 (HD)
• Complete metadata extraction including video title, duration, uploader, and unique ID
• Multiple thumbnail access for various use cases (preview, analysis, archival)
• Intelligent format selection with automatic identification of the highest quality stream (best_format)

---

Input Configuration

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

Input Specifications

Parameter	Type	Required	Description
video_urls	Array	Yes	TikTok Video URLs to process
url	String	Yes	Valid TikTok Video URL (must be a direct video link)
method	String	Yes	HTTP method (GET 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/.../thumbnail.jpg",
      "extractor": "TikTok",
      "direct_url": "https://api.apify.com/.../video.mp4"
    },
    "formats": [
      {
        "width": 720,
        "url": "https://api.apify.com/.../720p.mp4",
        "height": 1280,
        "ext": "mp4"
      },
      {
        "width": 576,
        "url": "https://api.apify.com/.../540p.mp4",
        "height": 1024,
        "ext": "mp4"
      }
    ],
    "best_format": {
      "width": 720,
      "url": "https://api.apify.com/.../720p.mp4",
      "height": 1280,
      "ext": "mp4"
    },
    "thumbnails": [
      {
        "url": "https://api.apify.com/.../thumbnail_0.webp"
      },
      {
        "url": "https://api.apify.com/.../thumbnail_1.jpg"
      }
    ]
  }
]

Output Field Documentation

Source Information

Field	Description
source_url	The original TikTok video URL that was processed.

Metadata Section

Field	Description
metadata.id	The unique TikTok ID for the video.
metadata.title	The full title/description of the video.
metadata.webpage_url	The canonical URL of the video on TikTok.
metadata.duration	Video length in seconds.
metadata.uploader	TikTok username of the content creator.
metadata.thumbnail	URL to the primary video thumbnail image.
metadata.extractor	Source platform identifier (TikTok).
metadata.direct_url	Direct download URL for a processed video stream.

Available Formats

Field	Description
formats	An array of objects detailing each available video quality.
formats[].width	Horizontal resolution in pixels.
formats[].height	Vertical resolution in pixels.
formats[].url	Direct download URL for this specific quality.
formats[].ext	Container format (mp4).

Curated Output

Field	Description
best_format	An object containing the details of the highest quality video stream available, for convenience.
thumbnails	An array of URLs providing access to multiple thumbnail images in different formats and potentially different frames.

---

Quality Tiers Available

The actor automatically detects and provides multiple quality options:

1. High Definition (HD) - Up to 720x1280 resolution for the best available quality.
2. Standard Definition (SD) - Various intermediate resolutions (e.g., 576x1024) for bandwidth efficiency.
3. Curated Selection - The best_format field automatically selects the highest quality stream for simplified downloading.

Each stream is provided as a direct download URL for maximum reliability.

---

Technical Features

Advanced Format Support

• Multi-format extraction (H.264, ByteVC1 codecs)
• Multiple resolution provisioning
• Direct MP4 container access for universal compatibility

Comprehensive Metadata Extraction

• Unique video ID for tracking and de-duplication
• Precise duration timing
• Uploader attribution and video title
• Direct links to the source webpage

Reliability & Performance

• Direct, signed URLs for high-speed downloading from Apify's key-value store
• Multiple thumbnail options for preview and analysis
• Robust error handling and URL validation
• Structured JSON output for easy parsing and integration

---

Enterprise Applications

Content Creation & Marketing Agencies

• Source trending TikTok content for repurposing in marketing campaigns.
• Archive client content for performance reporting and compliance.
• Conduct competitive analysis by downloading and reviewing competitor videos.

Social Listening & Research Platforms

• Ingest video content for sentiment analysis and trend tracking.
• Build datasets for academic research on social media trends and video content.
• Monitor branded content and influencer marketing campaigns.

Development & Integration Teams

• Seamlessly integrate TikTok content into third-party applications, CMS, or social media management tools.
• Build content aggregation platforms that feature TikTok videos.
• Develop automated workflows for content moderation or curation.

Data Archiving & Backup Services

• Provide clients with a reliable method to archive their TikTok content.
• Create personal backups of creative video assets.
• Ensure preservation of important cultural or commercial content from the platform.