---

Tiktok Video Downloader 🎯

Download TikTok videos quickly and extract their metadata effortlessly. Get high-resolution videos stored directly in a Key-Value Store for instant access.

---

📝 Actor Overview

This actor allows you to provide one or more TikTok video URLs. For each video, it:

1. Retrieves detailed metadata such as title, description, thumbnail, and resolution.
2. Downloads the video in highest available resolution.
3. Uploads the video and thumbnail to a Key-Value Store for easy access.
4. Outputs a structured dataset containing metadata and download URLs.

Key advantages:

• Works with multiple videos in batch mode.
• Supports high-resolution downloads up to 4K.
• Outputs are structured for easy automation and analysis.
• Videos are uploaded to a secure Key-Value Store, enabling quick retrieval.

---

⚡ Key Features

• ✅ High-resolution video downloads – up to 4K when available.
• ✅ Metadata extraction – including title, description, thumbnail, resolution.
• ✅ Key-Value Store upload – instant access to downloaded videos and thumbnails.
• ✅ Multiple URLs support – process several TikTok videos in one run.
• ✅ Optional proxy support – for videos with restricted access.
• ✅ Reliable output format – structured JSON for datasets or integrations.

---

📝 Description

Easily download TikTok videos and retrieve detailed metadata such as title, description, thumbnail, and resolution. Videos are uploaded directly to a Key-Value Store, supporting resolutions up to 4K.

---

Input Fields:

Field	Type	Description
startUrls	array	List of TikTok video URLs to download and extract metadata

---

Example input:

{
    "startUrls": [
        {
            "url": "https://www.tiktok.com/@ummi.edit/video/7463025935286078753",
            "method": "GET"
        },
        {
            "url": "https://www.tiktok.com/@seraphina_31/video/7470078840455318806",
            "method": "GET"
        }
    ]
}

📤 Output Example :

Every processed URL produces one JSON object pushed into the default dataset.

Structure Overview

[
  {
    "url": "https://www.tiktok.com/@ummi.edit/video/7463025935286078753",
    "title": "[4K Edit] Sonic the Hedgehog 3 🦔💨⚡️ #sonic #sonicthehedgehog3 #keanur...",
    "description": "[4K Edit] Sonic the Hedgehog 3 🦔💨⚡️ #sonic #sonicthehedgehog3 #keanureeves #jimcarrey #action #adventure #animation #lighting #fyppppppppppppppppppppppp #4kquality #4kedit ",
    "thumbnail": "https://api.apify.com/v2/key-value-stores/fZUnXhv75bs3U8YGH/records/thumbnail_7463025935286078753_1766675350.jpg",
    "resolution": "1920p",
    "downloadUrl": "https://api.apify.com/v2/key-value-stores/fZUnXhv75bs3U8YGH/records/video_7463025935286078753_1766675349.mp4",
    "status": "success"
  },
  {
    "url": "https://www.tiktok.com/@seraphina_31/video/7470078840455318806",
    "title": "#pander #aiart #fyp #forupage ",
    "description": "#pander #aiart #fyp #forupage ",
    "thumbnail": "https://api.apify.com/v2/key-value-stores/fZUnXhv75bs3U8YGH/records/thumbnail_7470078840455318806_1766675352.jpg",
    "resolution": "1280p",
    "downloadUrl": "https://api.apify.com/v2/key-value-stores/fZUnXhv75bs3U8YGH/records/video_7470078840455318806_1766675352.mp4",
    "status": "success"
  }
]

Output Fields Explained:

Field	Description
url	Original TikTok video URL provided as input.
title	Video title or main description from TikTok.
description	Full text description of the video.
thumbnail	URL of the video thumbnail uploaded to Key-Value Store.
resolution	Highest available resolution of the downloaded video (e.g., 1080p, 2K, 4K).
downloadUrl	Direct URL to the downloaded video in the Key-Value Store.
status	Indicates whether the video processing was success or failed.

---

🖼 Screenshots / Examples

Example workflow:

1. Input multiple TikTok URLs.
2. Actor downloads videos and thumbnails.
3. Outputs structured JSON with metadata and KVS URLs.
4. Videos are instantly available for download or sharing.

📌 Screenshot: (You can add GIFs or screenshots here showing the Actor input/output on Apify platform)

---

💡 Benefits & Advantages

• Save time: Batch process multiple videos simultaneously.
• High-quality content: Access 4K resolution videos whenever available.
• Metadata extraction: Quickly get video details for analytics or content management.
• Direct KVS upload: No need for local storage; access files instantly.
• Automation-ready: Outputs are structured for easy integration with workflows.
• Safe & reliable: Handles video downloads and errors gracefully.

---

🚀 How to Use

1. Go to the Actor input section.
2. Provide one or more TikTok video URLs in startUrls.
3. Run the actor.
4. Check the Dataset output for video metadata and Key-Value Store download links.
5. Optionally, download videos or thumbnails from the KVS URLs.

🟢 Tip: You can provide a proxy configuration if some videos are restricted or geo-blocked.

---

🔧 Best Practices

• Ensure the video URLs are public and accessible.
• Always verify the status field in output to confirm successful processing.
• For batch downloads, provide multiple URLs as an array of objects.
• Use a proxy configuration if videos are restricted in your region.
• Avoid providing private or deleted videos as inputs to prevent errors.

---

⚠️ Possible Errors & How to Avoid

Error	Cause	Solution
No URLs provided	startUrls is empty	Add valid TikTok video URLs.
Video download failed	Video deleted, private, or unavailable	Confirm video availability or provide public URLs.
Thumbnail download failed	Network issue or invalid thumbnail URL	Retry or check thumbnail URL.
Resolution not available	Requested resolution is higher than available	Actor downloads the highest available resolution automatically.

---

📈 Ideal Use Cases

• Content creators downloading their own videos for backup.
• Analysts extracting TikTok metadata for research.
• Marketers collecting video content for campaigns.
• Developers integrating TikTok video downloads into automation workflows.

---

📫 Contact / Support

For any issues, questions, or feature requests, contact: 📧 alphascraper69@gmail.com

---

Here my another actors :

Youtube Iteams:

• 🎶 Youtube Audio Downloader (Video/Shorts)
• Youtube Video Downloader Advanced
• Youtube Video Downloader ( Soundless )
• Youtube Video Downloader
• Youtube Video Details Scraper
• Youtube Transcript Ninja (Subtitles)
• Youtube Thumbnails Downloader & Scraper
• Youtube Tags or Hashtags Scraper
• Youtube Tags Scraper
• Youtube Shorts Scraper lite
• Youtube Shorts Downloader Pro
• Youtube Shorts Comments Scraper
• Youtube Community Posts Scraper
• Youtube Channel Id Scraper Pro
• Youtube Video Transcript Scraper ( Subtitles )
• Youtube Video Comments Scraper
• Youtube Shorts Scraper Pro
• Youtube Shorts Scraper
• Youtube Channel Scraper
• YouTube Video Description Extractor
• YouTube Hashtag Scraper
• YouTube Description Scraper pro
• YouTube Comments Scraper | Pay Per Result
• YouTube Channel ID Scraper

Tiktok Iteams:

• Tiktok Video Downloader
• Tiktok Video Details Scraper Pro
• Tiktok Profile Scraper
• TikTok Video Scraper
• TikTok Profile Videos Scraper
• TikTok Profile Scraper pro
• TikTok Audio Downloader 🎵

Snapchat Iteams:

• Snapchat Video Downloader (Spotlight )
• Snapchat Video Details Scraper (Spotlight)
• Snapchat Followers Scraper
• Snapchat Profile Scraper
• Snapchat Profile Scraper Mini

Instagram Iteams:

• Instagram video Downloader + Scraper
• Instagram Video Downloader (Soundlss)
• Instagram Thumbnail Scraper Video & Reels
• Instagram Reels Downloader
• Instagram Profile URL to Username Converter & Extractor
• Instagram Profile Scraper
• Instagram Post Videos Downloader
• Instagram Followers Scraper
• Instagram Audio Downloader
• Instagram Video Scraper + Downloader
• Instagram Video scraper Advanced
• Instagram Video Details scraper
• Instagram Reels Details scraper
• Instagram Followers Scraper Pro

Facebook Iteams:

• Facebook reels Downloader (Separate audio or video)
• Facebook Video Downloader advanced
• Facebook Video Details Scraper Advanced
• Facebook Video Details Scraper
• Facebook Transcript & Subtitle scraper
• Facebook Thumbnail Downloader Video & Reels
• Facebook Reels Downloader Advanced
• Facebook Reels Details Scraper Best and Affordable
• Facebook Reels Details Scraper
• Facebook Page Details Scraper
• Facebook Audio Downloader

Amazon Iteams:

• Amazon Search Scraper
• Amazon Product Details Scraper