---

TikTok Video Scraper 🎯

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

---