# TikTok Downloader (`serpdownloaders/tiktok-downloader`) Actor Browser extension for saving TikTok videos directly from your feed, profile, and video pages using your logged-in browser session. - **URL**: https://apify.com/serpdownloaders/tiktok-downloader.md - **Developed by:** [SERP Downloaders](https://apify.com/serpdownloaders) (community) - **Categories:** Videos, Automation, Social media - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 Downloader (Browser Extension) > Download supported TikTok videos as MP4 files, including workflows that avoid the default watermark save path. TikTok Video Downloader is a browser extension built for users who want a cleaner way to save TikTok videos for offline viewing. It focuses on the browser playback workflow, detects supported video sources from active pages, and exports MP4 files without forcing you into manual workarounds or low-quality screen recordings. - Save supported TikTok videos from watch pages, profiles, and feed contexts - Favor cleaner source workflows instead of the default app-download path - Export MP4 files for offline viewing and editing - Keep the workflow browser-based and simple - Avoid manual source tracing through network requests ### Links - :rocket: Get it here: [TikTok Video Downloader](https://serp.ly/tiktok-video-downloader) - :new: Latest release: [GitHub Releases](https://github.com/serpapps/tiktok-video-downloader/releases/latest) - :question: Help center: [SERP Help](https://help.serp.co/en/) - :beetle: Report bugs: [GitHub Issues](https://github.com/serpapps/tiktok-video-downloader/issues) - :bulb: Request features: [Feature Requests](https://github.com/serpapps/tiktok-video-downloader/issues) ### Preview ![TikTok Video Downloader workflow preview](assets/workflow-preview.webp) ### Table of Contents - [Why TikTok Video Downloader](#why-tiktok-video-downloader) - [Features](#features) - [How It Works](#how-it-works) - [Step-by-Step Tutorial: How to Download Videos from TikTok](#step-by-step-tutorial-how-to-download-videos-from-tiktok) - [Supported Formats](#supported-formats) - [Who It's For](#who-its-for) - [Common Use Cases](#common-use-cases) - [Troubleshooting](#troubleshooting) - [Trial & Access](#trial--access) - [Installation Instructions](#installation-instructions) - [FAQ](#faq) - [License](#license) - [Notes](#notes) - [About TikTok](#about-tiktok) ### Why TikTok Video Downloader TikTok's default save flow is built around the platform's own export behavior, not around flexible offline use. Browser users often want a cleaner path for saving videos from public pages, profiles, and feed views without depending on the in-app workflow or low-quality capture methods. TikTok Video Downloader is designed for that browser flow. It detects supported page media, lets you export a standard MP4, and keeps the process inside the browser for a faster save workflow. ### Features - Detects supported TikTok videos from active pages - In-feed download overlays on every video while browsing - Supports watch-page, profile, hashtag, music, and feed-oriented browser workflows - Downloads as standard MP4 without third-party watermarks - Automatic TikTok cookie and CDN auth handling for reliable downloads - Toggle download overlays on or off from the popup - Multi-strategy video detection that adapts to TikTok's changing page structure - Exports MP4 files for easier playback and reuse - Keeps the process browser-based with no extra software - Cross-browser support for Chrome, Edge, Brave, Opera, Firefox, Whale, and Yandex ### How It Works 1. Install the extension from the latest release. 2. Open TikTok in your browser and browse your feed or visit a video page. 3. Download overlays appear on every video in the feed. 4. Click the overlay button on any video card or open the extension popup. 5. Let the extension detect the active media source. 6. The video downloads as MP4 to your computer. 7. Open the saved file from your Downloads folder. ### Step-by-Step Tutorial: How to Download Videos from TikTok 1. Install TikTok Video Downloader from the latest GitHub release. 2. Open TikTok and sign in if you want access to your feed. 3. Browse your feed, visit a user profile, or navigate to a specific video page. 4. Let the page load fully so the video content initializes. 5. Click the download overlay on any video in your feed, or open the extension popup. 6. Review the detected download option shown by the extension. 7. The video downloads as MP4 without third-party watermarks. 8. Start the download and wait for the export to finish. 9. Open the saved file from your Downloads folder. ### Supported Formats - Input: supported TikTok browser video sources (feed, profiles, single video pages) - Input: TikTok CDN-delivered media with automatic auth handling - Output: MP4 Saved files use MP4 so they are easier to replay on standard media players, transfer between devices, or archive for later access. ### Who It's For - TikTok users who want offline copies of supported videos - Browser users who prefer a direct MP4 workflow - Creators saving references for editing or planning - Users who want a cleaner alternative to manual screen capture - Anyone who wants to avoid third-party download sites that add watermarks ### Common Use Cases - Save a TikTok video for offline viewing - Export a clip as MP4 for reference or editing - Keep public videos accessible after they disappear from the feed - Avoid low-quality recordings of browser playback - Download your own TikTok content for archival ### Troubleshooting **The extension does not detect the video** Start playback first and wait for the page to fully initialize the media source. **The page changed while scrolling the feed** Try scrolling past the video and back, or refresh the page so the extension can rescan the active page state. **The download option is missing** Refresh the page and retry after the video starts again. **No overlay buttons appear in the feed** Check that overlays are enabled in the popup. Toggle the overlay setting on if needed. **The download stopped or failed partway through** Check whether your internet connection dropped during the export. TikTok CDNs require specific cookies and headers, which the extension handles automatically. ### Trial & Access - Includes **3 free downloads** so you can test the workflow first - Email sign-in uses secure one-time password verification - No credit card required for the trial - Unlimited downloads are available with a paid license Start here: [https://serp.ly/tiktok-video-downloader](https://serp.ly/tiktok-video-downloader) ### Installation Instructions 1. Open the latest release page: [GitHub Releases](https://github.com/serpapps/tiktok-video-downloader/releases/latest) 2. Download the correct build for your browser. 3. Install the extension. 4. Open a TikTok page in your browser. 5. Use the popup to detect and download supported videos. ### FAQ **Can it save TikTok videos as MP4?** Yes. Supported downloads are exported as MP4 files. **Do downloads have watermarks?** No. Unlike third-party download websites, this extension downloads directly from TikTok's CDN without added watermarks. **Does it only work on single video pages?** It supports feed pages, user profiles, hashtag pages, music pages, and single video pages. **Can I turn off the download overlays?** Yes. Open the extension popup and toggle the overlay setting off. You can still download via the popup. **Do I need extra software?** No. The workflow is handled entirely by the browser extension. **What browsers are supported?** Chrome, Edge, Brave, Opera, Firefox, Whale, and Yandex. ### License This repository is distributed under the proprietary SERP Apps license in the [LICENSE](LICENSE) file. Review that file before copying, modifying, or redistributing any part of this project. ### Notes - Only download content you own or have explicit permission to save - An internet connection is required for downloads - Video must be loaded in the feed or on a video page before detection works - Quality depends on what TikTok makes available - Private videos require being logged into TikTok ### About TikTok TikTok is a short-form video platform with multiple browser playback contexts and platform-managed save behavior. TikTok Video Downloader is built to make supported browser downloads easier when you already have access to the content on the page. # Actor input Schema ## `listingNotice` (type: `string`): Optional informational field only. This actor currently serves as the public listing surface for the browser extension and does not yet expose a finalized runtime API contract. ## Actor input object example ```json { "listingNotice": "No runtime input is required yet. See the README and product page for the current extension workflow." } ```` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("serpdownloaders/tiktok-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 = {} # Run the Actor and wait for it to finish run = client.actor("serpdownloaders/tiktok-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 '{}' | apify call serpdownloaders/tiktok-downloader --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=serpdownloaders/tiktok-downloader", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TikTok Downloader", "description": "Browser extension for saving TikTok videos directly from your feed, profile, and video pages using your logged-in browser session.", "version": "0.0", "x-build-id": "c1DVevWq7HsoCuaBK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/serpdownloaders~tiktok-downloader/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-serpdownloaders-tiktok-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/serpdownloaders~tiktok-downloader/runs": { "post": { "operationId": "runs-sync-serpdownloaders-tiktok-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/serpdownloaders~tiktok-downloader/run-sync": { "post": { "operationId": "run-sync-serpdownloaders-tiktok-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", "properties": { "listingNotice": { "title": "Listing notice", "type": "string", "description": "Optional informational field only. This actor currently serves as the public listing surface for the browser extension and does not yet expose a finalized runtime API contract.", "default": "No runtime input is required yet. See the README and product page for the current extension workflow." } } }, "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 } } } } } } } } } } ```