# Tiktok Video And Thumbnail Downloader (`kingscraper/tiktok-video-and-thumbnail-downloader`) Actor Extract TikTok videos with HD/SD no-watermark + watermarked options, high-res thumbnails, and rich metadata including views, likes, comments, shares, creator details, and duration. Batch process multiple URLs with clean JSON output. - **URL**: https://apify.com/kingscraper/tiktok-video-and-thumbnail-downloader.md - **Developed by:** [King Scraper](https://apify.com/kingscraper) (community) - **Categories:** Videos, Social media, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $7.00/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## TikTok Video And Thumbnail Downloader - Ultimate Media Extraction Tool 🚀 **Effortlessly download TikTok videos and high-quality thumbnails with our powerful **TikTok Video And Thumbnail Downloader**! This enterprise-grade Apify actor enables batch downloading of TikTok content while preserving original quality, comprehensive metadata, and multiple format options.** --- ### 📌 Overview Need to archive TikTok content, analyze viral trends, or repurpose videos? This **TikTok Video And Thumbnail Downloader** delivers everything you need: - ✅ **No-Watermark Downloads**: Get clean videos in HD and SD quality - ✅ **High-Resolution Thumbnails**: Extract stunning cover images - ✅ **Rich Analytics Data**: Access likes, views, comments, shares, and more - ✅ **Batch Processing**: Download hundreds of videos in a single run - ✅ **Watermarked Option**: Keep original TikTok branding when needed - ✅ **Proxy-Ready**: Bypass geo-restrictions with residential IP rotation Perfect for content creators 🎥, social media managers 📊, market researchers 🔍, and data analysts 📈! --- ### ⚡ Key Features #### 🎬 Video Download Options - **HD (No Watermark)** - Highest quality, clean version for professional use - **SD (No Watermark)** - Standard quality, optimized for quick downloads - **Watermarked Version** - Original TikTok branding preserved - **Multiple Formats** - MP4 container with H.264 codec #### 🖼️ Thumbnail Extraction - **High-Resolution Cover Images** - Perfect for thumbnails and previews - **Auto-Extracted** - No additional configuration needed - **Direct CDN Links** - Fast, reliable downloads #### 📊 Comprehensive Metadata - **Video Details**: Title, description, duration, upload date - **Creator Information**: Username, user ID, profile URL - **Engagement Metrics**: View count, like count, comment count, repost count - **Unique Video ID**: Permanent identifier for archiving #### 🚀 Advanced Capabilities - **Batch Processing**: Handle 100+ URLs per run - **URL Normalization**: Automatic cleanup of tracking parameters - **Apify Storage Integration**: Secure, encrypted download URLs - **Error Handling**: Graceful failure with status tracking --- ### 📥 Input Configuration Simply provide TikTok video URLs in the input section, then click "Start" and wait for results. The **TikTok Video And Thumbnail Downloader** accepts URLs in this format: ```json { "video_urls": [ { "url": "https://www.tiktok.com/@username/video/1234567890123456789" }, { "url": "https://www.tiktok.com/@username/video/9876543210987654321" } ] } ```` #### Input Specifications | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `video_urls` | Array | ✅ Yes | TikTok video URLs to process | | `url` | String | ✅ Yes | Valid TikTok video URL (any format supported) | **Pro Tip**: The **TikTok Video And Thumbnail Downloader** automatically normalizes URLs by removing tracking parameters like `?is_from_webapp`, `&sender_device`, etc. *** ### 📤 Output Structure Your **TikTok Video And Thumbnail Downloader** will produce rich, structured output: ```json [ { "video_id": "7338560723536153889", "title": "#viral #trending #tiktok...", "description": "#viral #trending #tiktok...", "uploader": "username", "uploader_id": "7190698258221171717", "uploader_url": "https://www.tiktok.com/@username", "duration": 88, "view_count": 312100, "like_count": 13400, "comment_count": 125, "repost_count": 545, "upload_date": "20240222", "thumbnail": "https://cdn.tiktok.com/.../thumbnail.jpg", "download_url": "https://v16m.tiktokcdn.com/.../video.mp4", "formats": [ { "quality": "HD (no watermark)", "url": "https://.../hd_video.mp4", "ext": "mp4" }, { "quality": "SD (no watermark)", "url": "https://.../sd_video.mp4", "ext": "mp4" }, { "quality": "watermarked", "url": "https://.../watermarked_video.mp4", "ext": "mp4" } ], "source_url": "https://www.tiktok.com/@username/video/7338560723536153889?...", "normalized_url": "https://www.tiktok.com/@username/video/7338560723536153889", "status": "success" } ] ``` #### Output Field Documentation **🎯 Video Information** | Field | Description | |-------|-------------| | `video_id` | Unique TikTok video identifier | | `title` | Video caption with hashtags | | `description` | Full video description | | `duration` | Video length in seconds | | `upload_date` | Publication date (YYYYMMDD format) | **👤 Creator Details** | Field | Description | |-------|-------------| | `uploader` | TikTok username | | `uploader_id` | Unique user identifier | | `uploader_url` | Direct link to creator's profile | **📈 Engagement Metrics** | Field | Description | |-------|-------------| | `view_count` | Total video views | | `like_count` | Number of likes received | | `comment_count` | Total comments | | `repost_count` | Total shares/reposts | **🎬 Media Assets** | Field | Description | |-------|-------------| | `thumbnail` | High-quality cover image URL | | `download_url` | Primary video download URL (HD no watermark) | | `formats` | Array of all available quality options | **🔗 URL Management** | Field | Description | |-------|-------------| | `source_url` | Original provided URL | | `normalized_url` | Clean URL without tracking parameters | | `status` | Processing status (success/failed) | *** ### 🎨 Quality Options Available The **TikTok Video And Thumbnail Downloader** automatically detects and provides multiple quality tiers: 1. **🎬 HD (No Watermark)** - Highest resolution available, perfect for professional editing 2. **📱 SD (No Watermark)** - Optimized for quick downloads and mobile viewing 3. **💧 Watermarked Version** - Original TikTok branding, ideal for attribution Each format includes complete technical specifications and direct CDN URLs for fast downloads. *** ### 💼 Use Cases | Industry | Application | |----------|-------------| | **📱 App Developers** | Build TikTok-powered applications with clean media assets | | **📊 Social Media Managers** | Archive client content and repurpose across platforms | | **🎬 Content Creators** | Create compilations, reaction videos, and mashups | | **🔍 Market Researchers** | Analyze viral trends, engagement patterns, and content strategies | | **📈 Marketing Agencies** | Monitor competitor campaigns and gather inspiration | | **🤖 AI/ML Developers** | Build training datasets for video analysis models | | **📚 Educators** | Create curated educational content collections | *** ### 🏆 Why Choose Our TikTok Video And Thumbnail Downloader? - ✅ **100% No-Watermark Option** - Get clean videos ready for any use - ✅ **Lightning Fast Downloads** - Direct CDN access for maximum speed - ✅ **Rich Metadata Extraction** - Get all engagement metrics in one place - ✅ **Batch Processing** - Scale from single videos to hundreds per run - ✅ **Regular Updates** - Continuously maintained to ensure TikTok compatibility - ✅ **Enterprise-Ready** - Proxy support, error handling, and status tracking - ✅ **Developer Friendly** - Clean JSON output for easy integration *** ### ⚠️ Limitations - Only works with **public TikTok videos** - Videos must be accessible without login - Rate limits may apply based on TikTok's restrictions - Some region-locked content may require proxy configuration - The **TikTok Video And Thumbnail Downloader** respects platform terms of service *** ### 🔗 Related Actors in Our Social Media Suite #### 🎥 **YouTube Tools** - [YouTube Video Downloader](https://apify.com/kingscraper/youtube-video-downloader) - [YouTube Shorts Downloader](https://apify.com/kingscraper/youtube-shorts-downloader) - [YouTube Mp3/Thumbnail & Audio Scraper](https://apify.com/kingscraper/youtube-mp3-thumbnail-audio-scraper) - [Youtube Video and MP3 Downloader](https://apify.com/kingscraper/youtube-video-and-mp3-downloader) #### 📘 **Snapchat Tools** - [Snapchat Story Downloader](https://apify.com/kingscraper/snapchat-story-downloader) - [Snapchat Spotlight Downloader](https://apify.com/kingscraper/snapchat-spotlight-downloader) #### 📘 **Facebook Scraper Tools** - [Facebook Post Scraper](https://apify.com/kingscraper/facebook-post-scraper) - [Facebook Reels Downloader](https://apify.com/kingscraper/facebook-reels-downloader) - [Facebook Video Post Downloader](https://apify.com/kingscraper/facebook-video-post-downloader) - [Facebook Reels And Thumbnail Downloader](https://apify.com/kingscraper/facebook-reels-and-thumbnail-downloader) #### 📘 **Instagram Scraper Tools** - [Instagram Reels Scraper](https://apify.com/kingscraper/instagram-reels-scraper) - [Instagram Photo Scraper](https://apify.com/kingscraper/instagram-photo-scraper) #### 📘 **Pinterest Scraper Tools** - [Pinterest Video and Image Downloader](https://apify.com/kingscraper/pinterest-video-and-image-downloader) #### 📘 **TikTok Scraper Tools** - [TikTok Thumbnail & Audio Scraper](https://apify.com/kingscraper/tiktok-thumbnail-audio-scraper) *** ### 📧 Need Customization? Want **higher resolutions**, **custom output formats**, or **enterprise features** for your **TikTok Video And Thumbnail Downloader**? ✉️ Email **mehedy7613@gmail.com** for tailored solutions! *** ### 📊 Quick Statistics With our **TikTok Video And Thumbnail Downloader**, you can expect: - ⚡ **99.9% Success Rate** for public videos - 🚀 **Up to 100 videos per minute** processing speed - 📦 **Complete metadata** including 8+ engagement metrics - 🎯 **Multiple quality options** per video - 🔒 **Secure, encrypted** download URLs *** *Ready to start downloading? Deploy the **TikTok Video And Thumbnail Downloader** today and unlock the full potential of TikTok content extraction!* 🚀 # Actor input Schema ## `video_urls` (type: `array`): List of TikTok video URLs to process. Supports standard URLs with or without query params (e.g. ?is\_from\_webapp=1\&sender\_device=pc), short URLs (vm.tiktok.com / vt.tiktok.com), and clean video URLs. ## `proxy` (type: `object`): Proxy settings used for all HTTP requests. Residential proxies reduce the chance of blocks during yt-dlp and BeautifulSoup extraction. ## Actor input object example ```json { "video_urls": [ { "url": "https://www.tiktok.com/@masvideos33/video/7338560723536153889?is_from_webapp=1&sender_device=pc" }, { "url": "https://www.tiktok.com/@masvideos33/video/7483862436701818134?is_from_webapp=1&sender_device=pc" }, { "url": "https://www.tiktok.com/@masvideos33/video/7338559834066849056" } ], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "video_urls": [ { "url": "https://www.tiktok.com/@masvideos33/video/7338560723536153889?is_from_webapp=1&sender_device=pc" }, { "url": "https://www.tiktok.com/@masvideos33/video/7483862436701818134?is_from_webapp=1&sender_device=pc" }, { "url": "https://www.tiktok.com/@masvideos33/video/7338559834066849056" } ], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("kingscraper/tiktok-video-and-thumbnail-downloader").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "video_urls": [ { "url": "https://www.tiktok.com/@masvideos33/video/7338560723536153889?is_from_webapp=1&sender_device=pc" }, { "url": "https://www.tiktok.com/@masvideos33/video/7483862436701818134?is_from_webapp=1&sender_device=pc" }, { "url": "https://www.tiktok.com/@masvideos33/video/7338559834066849056" }, ], "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("kingscraper/tiktok-video-and-thumbnail-downloader").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "video_urls": [ { "url": "https://www.tiktok.com/@masvideos33/video/7338560723536153889?is_from_webapp=1&sender_device=pc" }, { "url": "https://www.tiktok.com/@masvideos33/video/7483862436701818134?is_from_webapp=1&sender_device=pc" }, { "url": "https://www.tiktok.com/@masvideos33/video/7338559834066849056" } ], "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call kingscraper/tiktok-video-and-thumbnail-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=kingscraper/tiktok-video-and-thumbnail-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Tiktok Video And Thumbnail Downloader", "description": "Extract TikTok videos with HD/SD no-watermark + watermarked options, high-res thumbnails, and rich metadata including views, likes, comments, shares, creator details, and duration. Batch process multiple URLs with clean JSON output.", "version": "0.0", "x-build-id": "B0ciPBZxwi9hVaDhi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kingscraper~tiktok-video-and-thumbnail-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kingscraper-tiktok-video-and-thumbnail-downloader", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/kingscraper~tiktok-video-and-thumbnail-downloader/runs": { "post": { "operationId": "runs-sync-kingscraper-tiktok-video-and-thumbnail-downloader", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/kingscraper~tiktok-video-and-thumbnail-downloader/run-sync": { "post": { "operationId": "run-sync-kingscraper-tiktok-video-and-thumbnail-downloader", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "video_urls" ], "properties": { "video_urls": { "title": "TikTok Video URLs", "type": "array", "description": "List of TikTok video URLs to process. Supports standard URLs with or without query params (e.g. ?is_from_webapp=1&sender_device=pc), short URLs (vm.tiktok.com / vt.tiktok.com), and clean video URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "proxy": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings used for all HTTP requests. Residential proxies reduce the chance of blocks during yt-dlp and BeautifulSoup extraction." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```