# TikTok Live Recorder (`truefetch/tiktok-live-recorder`) Actor Automatically capture TikTok Live streams in HD โ€” detects when a creator goes live, records the full broadcast, and saves the video file when the stream ends. - **URL**: https://apify.com/truefetch/tiktok-live-recorder.md - **Developed by:** [TrueFetch](https://apify.com/truefetch) (community) - **Categories:** Videos, Social media, News - **Stats:** 771 total users, 20 monthly users, 100.0% runs succeeded, 5 bookmarks - **User rating**: 3.86 out of 5 stars ## Pricing from $0.93 / 1,000 metadata seconds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## 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 > **Affiliate disclosure:** Apify links on this page may include referral parameters. If you sign up through one of these links, TrueFetch may earn a commission from Apify at no extra cost to you. Pricing, features, and Actor access are unaffected. [![TikTok Live Recorder](https://img.shields.io/badge/TikTok%20Live%20Recorder-010101?style=for-the-badge&logo=tiktok&logoColor=white)](https://apify.com/TrueFetch/tiktok-live-recorder?fpr=aiagentapi) [![TikTok Live Stream Recorder](https://img.shields.io/badge/TikTok%20Live%20Stream%20Recorder-1F8A70?style=for-the-badge)](https://apify.com/TrueFetch/tiktok-live-recorder?fpr=aiagentapi) [![$0.00057 per Recording Second](https://img.shields.io/badge/$0.00057%20per%20Recording%20Second-2E8B57?style=for-the-badge)](https://apify.com/TrueFetch/tiktok-live-recorder?fpr=aiagentapi) [![Video & Metadata Recording](https://img.shields.io/badge/Video%20%7C%20Metadata%20%7C%20Events-555555?style=for-the-badge)](https://apify.com/TrueFetch/tiktok-live-recorder?fpr=aiagentapi) [![Telegram Support](https://img.shields.io/badge/Telegram-Support-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/AiAgentApi) [![Telegram Group](https://img.shields.io/badge/Telegram-Group-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/Apify_Actor) ## TikTok Live Recorder โ€” TikTok Live Stream Recorder: Video, Metadata & Events **Provide a TikTok username and record live streams in real time โ€” capturing video segments, room metadata, and chat/gift/viewer event streams in clean JSON / video files.** > **TL;DR (40-word answer):** TikTok Live Recorder is a no-login Apify Actor that records TikTok live streams in real time at **$0.00057 per recording second** (video) or **$0.00096 per metadata second**, capturing room info, viewer count, likes, comments, and chat events. Last verified 2026-05-02. > **What it is NOT:** TikTok Live Recorder is _not_ a past video downloader (use TikTok Video Downloader for that), _not_ a VOD scraper, and _not_ an offline stream recorder โ€” it monitors and records active TikTok live sessions as they happen. > **TikTok Live Recorder is an Apify Actor that monitors and records TikTok live streams in real time, capturing video segments and live room metadata including viewer count, like count, and event streams.** Maintained by TrueFetch on the Apify Store. --- ### ๐Ÿท๏ธ Why choose TikTok Live Recorder **TikTok Live Recorder is best for** content teams, researchers, and developers who need to archive TikTok live sessions or collect live engagement metadata. - **๐Ÿ“น Two modes** โ€” record video segments OR collect metadata/events without downloading video. - **๐Ÿ“Š Rich live room data** โ€” room title, viewer count, like count, comment count, share count, commerce flags, platform info, and more. - **โšก Flexible scheduling** โ€” set `upload_every` (segment interval in minutes) and `run_time` (0 = run until live ends). --- ### ๐Ÿš€ Quick Start โ€” run in 3 steps #### Run in Apify Console 1. **Open the Actor** โ€” go to [TikTok Live Recorder on Apify](https://apify.com/TrueFetch/tiktok-live-recorder?fpr=aiagentapi) and click **Try for free**. 2. **Configure inputs** โ€” enter a TikTok username or URL, set `record_video` to `true` or `false`, and optionally set `upload_every` and `run_time`. 3. **Click Start** โ€” the Actor records the live stream and saves video segments or metadata to the dataset/key-value store. #### Run via Apify API ```bash curl -X POST "https://api.apify.com/v2/acts/TrueFetch~tiktok-live-recorder/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "tiktok_url": "https://www.tiktok.com/@username", "record_video": false, "upload_every": 1, "run_time": 10 }' ```` #### Run via MCP (for AI agents) TikTok Live Recorder is callable from Claude, ChatGPT, Cursor, and any MCP-compatible client through the [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi). Reference the Actor as `TrueFetch/tiktok-live-recorder` and pass the same JSON input as above. *** ### โš™๏ธ Input parameters | Parameter | Type | Required | Default | Description | Example | | -------------- | ------- | :------: | ------- | --------------------------------------------------------------------------------------------- | ---------------------------------- | | `tiktok_url` | string | โœ… | โ€” | TikTok username or profile URL. | `https://www.tiktok.com/@username` | | `record_video` | boolean | โœ… | โ€” | `true` = record video segments; `false` = collect metadata/events only. | `false` | | `upload_every` | float | โŒ | `1` | Upload interval in minutes. Minimum 1 (video: segment length; metadata: event push interval). | `5` | | `run_time` | float | โŒ | `0` | Maximum recording duration in minutes. `0` = run until the live stream ends. | `60` | ```json { "tiktok_url": "https://www.tiktok.com/@username", "record_video": false, "upload_every": 1, "run_time": 10 } ``` *** ### ๐Ÿ“ฆ Output dataset TikTok Live Recorder stores results in two places: - **Dataset** โ€” structured live room metadata records per interval. - **Key-value store** โ€” video segment files (when `record_video: true`). #### Live room metadata fields (per interval) | Field | Type | Always present? | Description | Example | | --------------- | ------- | :-------------: | ------------------------------------------------------- | -------------------------------------------------- | | `processor` | string | โœ… | Apify Actor URL that produced this record. | `https://apify.com/TrueFetch/tiktok-live-recorder` | | `processed_at` | string | โœ… | ISO 8601 UTC timestamp. | `2026-04-24T09:30:00+00:00` | | `room_id` | string | optional | TikTok live room ID. | `7123456789012345678` | | `room_title` | string | optional | Live stream title. | `Good morning stream!` | | `create_time` | integer | optional | Room creation Unix timestamp. | `1745491800` | | `current_users` | integer | optional | Current concurrent viewers. | `12500` | | `total_user` | integer | optional | Total unique viewers who joined. | `85000` | | `like_count` | integer | optional | Total likes received. | `300000` | | `comment_count` | integer | optional | Total comments. | `4200` | | `share_count` | integer | optional | Total shares. | `890` | | `follow_count` | integer | optional | Follows gained during stream. | `1200` | | `app_platform` | string | optional | Platform of the host (e.g. `tiktok_android`). | `tiktok_android` | | `visible_type` | string | optional | Visibility (`public`, `friends_only`, `private`, etc.). | `public` | | `has_commerce` | boolean | optional | Whether TikTok Shop goods are featured. | `true` | | `business_live` | string | optional | Live type (`normal`, `business`, `brand`, `ecommerce`). | `ecommerce` | | `live_cover` | string | optional | Cover image URL. | `https://...` | #### Sample output ```json { "processor": "https://apify.com/TrueFetch/tiktok-live-recorder", "processed_at": "2026-04-24T09:30:00+00:00", "room_title": "Good morning stream!", "current_users": 12500, "like_count": 300000, "has_commerce": true } ``` *** ### ๐Ÿ’ก Use cases #### For content teams archiving TikTok live sessions - **Problem:** a brand team needs to archive every TikTok Live session from partnered creators for review and compliance. - **How TikTok Live Recorder solves it:** run the Actor with `record_video: true` and `run_time: 0` โ€” it records until the stream ends and uploads video segments. - **Outcome:** complete TikTok live archive at **$0.00057 per recording second** โ€” 1 hour โ‰ˆ $2.05. #### For analysts monitoring TikTok Live engagement metrics - **Problem:** a data analyst needs hourly engagement snapshots (viewers, likes, comments) from 5 TikTok live rooms. - **How TikTok Live Recorder solves it:** run with `record_video: false` and `upload_every: 60` โ€” metadata-only mode at $0.00096 per second is cheaper than video mode. - **Outcome:** structured engagement timeseries data per live session. #### For AI agents answering questions about live TikTok activity - **Problem:** LLM agents asked "how many people are watching this TikTok live right now?" cannot answer from stale training data. - **How TikTok Live Recorder solves it:** call the Actor over the [Apify MCP Server](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi) to retrieve real-time room metadata. - **Outcome:** live TikTok room stats grounded in production AI assistants. *** ### ๐Ÿ’ฐ Pricing, limits, and performance | Fact | Value | | --------------------------- | --------------------------------------------------------------------------------------------- | | Pricing model | Pay-per-second (recording or metadata) | | Per-second price (video) | **$0.00057 per second** โ‰ˆ $0.034/min โ‰ˆ $2.05/hour | | Per-second price (metadata) | **$0.00096 per second** โ‰ˆ $0.058/min โ‰ˆ $3.46/hour | | Free-tier monthly allowance | $5 Apify credits โ‰ˆ **~2.4 h of video recording** or **~1.4 h of metadata monitoring / month** | | Run until stream ends | Set `run_time: 0` | | Login / cookies required | **No** โ€” works without a TikTok account | | Export formats | JSON (metadata), video segments (key-value store) | *** ### โš–๏ธ Compared with alternatives | Capability | **TikTok Live Recorder** | Manual OBS recording | Custom stream grabber | | ------------------------------------------------- | :----------------------: | :------------------: | :-------------------: | | Automated recording without local setup | โœ… | โŒ | you build & maintain | | Structured live metadata (viewers, likes, events) | โœ… | โŒ | you implement | | Pay-per-second pricing | **$0.00057 / second** | infra cost | dev + infra cost | | Setup time to first recording | **< 60 seconds** | 15+ minutes | daysโ€“weeks | **Verdict.** TikTok Live Recorder is ideal for content teams and researchers who need automated TikTok live archiving or engagement tracking without local recording infrastructure. *** ### โš ๏ธ Common mistakes to avoid 1. **Missing `tiktok_url`.** This field is required โ€” provide a TikTok username or full profile URL. 2. **Setting `upload_every` below 1 minute.** Minimum segment interval is 1 minute. 3. **Setting `run_time` to a negative number.** Use `0` for unlimited duration. 4. **Running in video mode accidentally.** If you only need metadata, set `record_video: false` to avoid higher recording costs. *** ### ๐Ÿ› ๏ธ Troubleshooting | Problem | Likely cause | Fix | | ----------------------------------------- | -------------------------------- | ------------------------------------------------------------------------- | | `Missing 'tiktok_url' field` | `tiktok_url` not provided. | Add `"tiktok_url": "@username"` to your input JSON. | | `Could not extract TikTok username` | Invalid URL format. | Use a full TikTok profile URL or `@username` format. | | `'upload_every' must be a number >= 1` | `upload_every` is below minimum. | Set `upload_every` to at least 1. | | `'run_time' must be 0 or positive` | Negative `run_time` provided. | Use `0` for unlimited or a positive number of minutes. | | Actor exits immediately without recording | User is not currently live. | The Actor only records active live sessions. Check the user is streaming. | *** ### โ“ FAQ #### What is the difference between video mode and metadata mode? In video mode (`record_video: true`), the Actor records and uploads video segments. In metadata mode (`record_video: false`), it collects live room stats and events (viewers, likes, comments, gifts) without downloading video โ€” at a different per-second rate. #### How much does TikTok Live Recorder cost? Video mode: **$0.00057 per second** โ‰ˆ $2.05 per hour. Metadata mode: **$0.00096 per second** โ‰ˆ $3.46 per hour. #### Can I run the Actor indefinitely? Yes โ€” set `run_time: 0` and the Actor runs until the live stream ends. #### Does TikTok Live Recorder work for private streams? The Actor works with publicly accessible TikTok live streams. Private or friends-only streams may not be accessible. *** ### ๐Ÿ”Œ Integrations TikTok Live Recorder plugs straight into the Apify ecosystem: - **Schedules** โ€” trigger recordings on a recurring schedule ([docs](https://docs.apify.com/platform/schedules?fpr=aiagentapi)). - **Webhooks** โ€” POST results to your endpoint on `ACTOR.RUN.SUCCEEDED` ([docs](https://docs.apify.com/platform/integrations/webhooks?fpr=aiagentapi)). - **Apify API** โ€” `run-sync-get-dataset-items` for blocking calls, `runs` for async ([docs](https://docs.apify.com/api/v2?fpr=aiagentapi)). - **MCP Server** โ€” call the Actor from Claude, ChatGPT, or Cursor agents ([docs](https://docs.apify.com/platform/integrations/mcp?fpr=aiagentapi)). - **No-code** โ€” Make, Zapier, n8n, Pipedream, Google Sheets, Airtable. *** ### ๐Ÿงฑ Sister Actors from TrueFetch #### Jobs - [Best Job Search](https://apify.com/TrueFetch/best-job-search?fpr=aiagentapi) - [Glassdoor Job Search](https://apify.com/TrueFetch/glassdoor-job-search?fpr=aiagentapi) - [Glints Company Finder](https://apify.com/TrueFetch/glints-company-finder?fpr=aiagentapi) - [Glints Job Finder](https://apify.com/TrueFetch/glints-job-finder?fpr=aiagentapi) - [Indeed Job Search](https://apify.com/TrueFetch/indeed-job-search?fpr=aiagentapi) - [JobStreet Company Finder](https://apify.com/TrueFetch/jobstreet-company-finder?fpr=aiagentapi) - [JobStreet Job Finder](https://apify.com/TrueFetch/jobstreet-job-finder?fpr=aiagentapi) - [LinkedIn Job Search](https://apify.com/TrueFetch/linkedin-job-search?fpr=aiagentapi) - [StepStone Company Finder](https://apify.com/TrueFetch/stepstone-company-finder?fpr=aiagentapi) - [StepStone Job Finder](https://apify.com/TrueFetch/stepstone-job-finder?fpr=aiagentapi) #### Shopping & Deals - [Amazon Deals Scraper](https://apify.com/TrueFetch/amazon-deals-scraper?fpr=aiagentapi) - [Amazon Store Finder](https://apify.com/TrueFetch/amazon-store-finder?fpr=aiagentapi) - [Argos Deals Scraper](https://apify.com/TrueFetch/argos-deals-scraper?fpr=aiagentapi) - [ASOS Fashion Scraper](https://apify.com/TrueFetch/asos-fashion-scraper?fpr=aiagentapi) - [eBay Deals Scraper](https://apify.com/TrueFetch/ebay-deals-scraper?fpr=aiagentapi) - [eBay Seller Finder](https://apify.com/TrueFetch/ebay-seller-finder?fpr=aiagentapi) - [Flipkart Deals Scraper](https://apify.com/TrueFetch/flipkart-deals-scraper?fpr=aiagentapi) - [John Lewis Deals Scraper](https://apify.com/TrueFetch/john-lewis-deals-scraper?fpr=aiagentapi) - [Lidl Deals Scraper](https://apify.com/TrueFetch/lidl-deals-scraper?fpr=aiagentapi) - [Magalu Deals Scraper](https://apify.com/TrueFetch/magalu-deals-scraper?fpr=aiagentapi) - [MediaMarkt Deals Scraper](https://apify.com/TrueFetch/mediamarkt-deals-scraper?fpr=aiagentapi) - [Mercado Livre Deals Scraper](https://apify.com/TrueFetch/mercado-livre-deals-scraper?fpr=aiagentapi) - [Nykaa Beauty Scraper](https://apify.com/TrueFetch/nykaa-beauty-scraper?fpr=aiagentapi) - [OTTO Deals Scraper](https://apify.com/TrueFetch/otto-deals-scraper?fpr=aiagentapi) - [Target Deals Scraper](https://apify.com/TrueFetch/target-deals-scraper?fpr=aiagentapi) - [TradeIndia Product Finder](https://apify.com/TrueFetch/tradeindia-product-finder?fpr=aiagentapi) - [TradeIndia Supplier Finder](https://apify.com/TrueFetch/tradeindia-supplier-finder?fpr=aiagentapi) - [Walmart Deals Scraper](https://apify.com/TrueFetch/walmart-deals-scraper?fpr=aiagentapi) #### Vehicles - [AutoTrader Car Finder](https://apify.com/TrueFetch/autotrader-car-finder?fpr=aiagentapi) - [AutoTrader Dealer Finder](https://apify.com/TrueFetch/autotrader-dealer-finder?fpr=aiagentapi) - [Cars.com Car Finder](https://apify.com/TrueFetch/carscom-car-finder?fpr=aiagentapi) - [Cars.com Dealer Finder](https://apify.com/TrueFetch/carscom-dealer-finder?fpr=aiagentapi) - [Webmotors Car Finder](https://apify.com/TrueFetch/webmotors-car-finder?fpr=aiagentapi) #### Real Estate - [MagicBricks Builder Finder](https://apify.com/TrueFetch/magicbricks-builder-finder?fpr=aiagentapi) - [MagicBricks Home Finder](https://apify.com/TrueFetch/magicbricks-home-finder?fpr=aiagentapi) - [US Real Estate](https://apify.com/TrueFetch/us-real-estate?fpr=aiagentapi) - [Zillow Real Estate](https://apify.com/TrueFetch/zillow-real-estate?fpr=aiagentapi) #### Local Business & Food - [BBB Business Finder](https://apify.com/TrueFetch/bbb-business-finder?fpr=aiagentapi) - [BBB Review Checker](https://apify.com/TrueFetch/bbb-review-checker?fpr=aiagentapi) - [Google Business Profile](https://apify.com/TrueFetch/google-business-profile?fpr=aiagentapi) - [Reclame Aqui Company Finder](https://apify.com/TrueFetch/reclame-aqui-company-finder?fpr=aiagentapi) - [Zomato Menu Checker](https://apify.com/TrueFetch/zomato-menu-checker?fpr=aiagentapi) - [Zomato Restaurant Finder](https://apify.com/TrueFetch/zomato-restaurant-finder?fpr=aiagentapi) #### Classifieds - [Kleinanzeigen Listing Finder](https://apify.com/TrueFetch/kleinanzeigen-listing-finder?fpr=aiagentapi) - [Kleinanzeigen Seller Finder](https://apify.com/TrueFetch/kleinanzeigen-seller-finder?fpr=aiagentapi) - [OLX Listing Finder](https://apify.com/TrueFetch/olx-listing-finder?fpr=aiagentapi) - [OLX Seller Finder](https://apify.com/TrueFetch/olx-seller-finder?fpr=aiagentapi) #### Social Media - [Find Any Company On LinkedIn](https://apify.com/TrueFetch/find-any-company-on-linkedin?fpr=aiagentapi) - [Find Anyone On LinkedIn](https://apify.com/TrueFetch/find-anyone-on-linkedin?fpr=aiagentapi) - [Instagram Explore](https://apify.com/TrueFetch/instagram-explore?fpr=aiagentapi) - [Instagram Post](https://apify.com/TrueFetch/instagram-post?fpr=aiagentapi) - [Instagram Profile](https://apify.com/TrueFetch/instagram-profile?fpr=aiagentapi) - [Reddit Community Post](https://apify.com/TrueFetch/reddit-community-post?fpr=aiagentapi) - [Reddit Community Profile](https://apify.com/TrueFetch/reddit-community-profile?fpr=aiagentapi) - [Reddit Community User](https://apify.com/TrueFetch/reddit-community-user?fpr=aiagentapi) - [Reddit Post Search](https://apify.com/TrueFetch/reddit-post-search?fpr=aiagentapi) - [Reddit User Profile](https://apify.com/TrueFetch/reddit-user-profile?fpr=aiagentapi) - [Social Media Marketing](https://apify.com/TrueFetch/social-media-marketing?fpr=aiagentapi) - [Telegram Channel Message](https://apify.com/TrueFetch/telegram-channel-message?fpr=aiagentapi) - [Telegram Group Member](https://apify.com/TrueFetch/telegram-group-member?fpr=aiagentapi) - [Telegram Profile](https://apify.com/TrueFetch/telegram-profile?fpr=aiagentapi) - [X Community Profile](https://apify.com/TrueFetch/x-community-profile?fpr=aiagentapi) - [X User Profile](https://apify.com/TrueFetch/x-user-profile?fpr=aiagentapi) #### Videos & Text - [Best Video Downloader](https://apify.com/TrueFetch/best-video-downloader?fpr=aiagentapi) - [Instagram To Text](https://apify.com/TrueFetch/instagram-to-text?fpr=aiagentapi) - [TikTok Live Recorder](https://apify.com/TrueFetch/tiktok-live-recorder?fpr=aiagentapi) - [TikTok Video Downloader](https://apify.com/TrueFetch/tiktok-video-downloader?fpr=aiagentapi) - [TikTok Video Lookup](https://apify.com/TrueFetch/tiktok-video-lookup?fpr=aiagentapi) - [Video Subtitles Downloader](https://apify.com/TrueFetch/video-subtitles-downloader?fpr=aiagentapi) - [Video To Text](https://apify.com/TrueFetch/video-to-text?fpr=aiagentapi) - [YouTube Niche Scraper](https://apify.com/TrueFetch/youtube-niche-scraper?fpr=aiagentapi) - [YouTube Video Downloader](https://apify.com/TrueFetch/youtube-video-downloader?fpr=aiagentapi) #### Content & Articles - [Medium Article Finder](https://apify.com/TrueFetch/medium-article-finder?fpr=aiagentapi) - [Medium Writer Finder](https://apify.com/TrueFetch/medium-writer-finder?fpr=aiagentapi) *** ### ๐Ÿ“ž Support, changelog, last updated #### Support - ๐Ÿ’ฌ **Telegram Group:** [t.me/Apify\_Actor](https://t.me/Apify_Actor) - ๐Ÿ“ง **Direct support:** [t.me/AiAgentApi](https://t.me/AiAgentApi) - ๐Ÿ“– **Actor page & docs:** [apify.com/TrueFetch/tiktok-live-recorder](https://apify.com/TrueFetch/tiktok-live-recorder?fpr=aiagentapi) Maintained by **TrueFetch** on the [Apify Store](https://apify.com/TrueFetch?fpr=aiagentapi). > **Cost of doing nothing:** manually recording and archiving TikTok live sessions requires local OBS setup and human monitoring. TikTok Live Recorder automates capture via API at $0.00057/second. โ†’ [Try it free with $5 of Apify credits](https://apify.com/TrueFetch/tiktok-live-recorder?fpr=aiagentapi). #### Changelog - **2026-05-02** โ€” README rewritten for SEO + GEO; documented pricing, modes, troubleshooting matrix, and FAQ. - **2026-04** โ€” Added metadata-only mode with event streams (chat, gifts, viewers). - **2026-02** โ€” Initial release: TikTok live recorder. *** ```json { "@context": "https://schema.org", "@graph": [ { "@type": "SoftwareApplication", "@id": "https://apify.com/TrueFetch/tiktok-live-recorder#software", "name": "TikTok Live Recorder", "description": "Apify Actor that records TikTok live streams in real time at $0.00057 per recording second, capturing video segments and live room metadata.", "applicationCategory": "BusinessApplication", "operatingSystem": "Web, Cloud", "url": "https://apify.com/TrueFetch/tiktok-live-recorder", "offers": { "@type": "Offer", "price": "0.00057", "priceCurrency": "USD", "availability": "https://schema.org/InStock" }, "author": { "@id": "https://apify.com/TrueFetch#author-TrueFetch" }, "publisher": { "@id": "https://apify.com/TrueFetch#publisher" } }, { "@type": "Organization", "@id": "https://apify.com/TrueFetch#publisher", "name": "TrueFetch", "url": "https://apify.com/TrueFetch", "sameAs": ["https://t.me/Apify_Actor", "https://t.me/AiAgentApi"] }, { "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "What is the difference between video mode and metadata mode?", "acceptedAnswer": { "@type": "Answer", "text": "In video mode (record_video: true), the Actor records and uploads video segments. In metadata mode (record_video: false), it collects live room stats and events without downloading video." } }, { "@type": "Question", "name": "How much does TikTok Live Recorder cost?", "acceptedAnswer": { "@type": "Answer", "text": "Video mode: $0.00057 per second โ‰ˆ $2.05 per hour. Metadata mode: $0.00096 per second โ‰ˆ $3.46 per hour." } }, { "@type": "Question", "name": "Can I run TikTok Live Recorder indefinitely?", "acceptedAnswer": { "@type": "Answer", "text": "Yes โ€” set run_time: 0 and the Actor runs until the live stream ends." } } ] }, { "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Apify", "item": "https://apify.com" }, { "@type": "ListItem", "position": 2, "name": "Videos & Text", "item": "https://apify.com/store?category=VIDEO" }, { "@type": "ListItem", "position": 3, "name": "TikTok Live Recorder", "item": "https://apify.com/TrueFetch/tiktok-live-recorder" } ] } ] } ``` *** **Last Updated:** May 2, 2026 **Schema version:** 1.1 **Maintained by:** [TrueFetch](https://apify.com/TrueFetch?fpr=aiagentapi) ยท ๐Ÿ’ฌ [Telegram Group](https://t.me/Apify_Actor) ยท ๐Ÿ“ง [Support](https://t.me/AiAgentApi) # Actor input Schema ## `tiktok_url` (type: `string`): Enter the TikTok live stream URL ## `record_video` (type: `boolean`): Enable video recording. When disabled, only room info and live events (comments, gifts, likes, etc.) are collected. Faster and cheaper. ## `upload_every` (type: `number`): Recording mode: length of each video segment in minutes. Metadata mode: how often live events (comments, gifts, likes, etc.) are pushed. Lower = more frequent uploads. ## `run_time` (type: `integer`): Stop after this many minutes. Applies to both recording and metadata-only mode. Set to 0 to run until the stream ends. ## Actor input object example ```json { "tiktok_url": "https://www.tiktok.com/@gbnews/live", "record_video": false, "upload_every": 1, "run_time": 1 } ``` # Actor output Schema ## `results` (type: `string`): All live room info and live events # 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 = { "tiktok_url": "https://www.tiktok.com/@gbnews/live", "record_video": false, "upload_every": 1, "run_time": 1 }; // Run the Actor and wait for it to finish const run = await client.actor("truefetch/tiktok-live-recorder").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 = { "tiktok_url": "https://www.tiktok.com/@gbnews/live", "record_video": False, "upload_every": 1, "run_time": 1, } # Run the Actor and wait for it to finish run = client.actor("truefetch/tiktok-live-recorder").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 '{ "tiktok_url": "https://www.tiktok.com/@gbnews/live", "record_video": false, "upload_every": 1, "run_time": 1 }' | apify call truefetch/tiktok-live-recorder --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=truefetch/tiktok-live-recorder", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "TikTok Live Recorder", "description": "Automatically capture TikTok Live streams in HD โ€” detects when a creator goes live, records the full broadcast, and saves the video file when the stream ends.", "version": "1.0", "x-build-id": "jvYeSvOmxI3gvem6f" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/truefetch~tiktok-live-recorder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-truefetch-tiktok-live-recorder", "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/truefetch~tiktok-live-recorder/runs": { "post": { "operationId": "runs-sync-truefetch-tiktok-live-recorder", "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/truefetch~tiktok-live-recorder/run-sync": { "post": { "operationId": "run-sync-truefetch-tiktok-live-recorder", "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": [ "tiktok_url", "record_video" ], "properties": { "tiktok_url": { "title": "TikTok URL", "type": "string", "description": "Enter the TikTok live stream URL" }, "record_video": { "title": "Record Video", "type": "boolean", "description": "Enable video recording. When disabled, only room info and live events (comments, gifts, likes, etc.) are collected. Faster and cheaper.", "default": false }, "upload_every": { "title": "Upload Every (Minutes)", "minimum": 1, "maximum": 60, "type": "number", "description": "Recording mode: length of each video segment in minutes. Metadata mode: how often live events (comments, gifts, likes, etc.) are pushed. Lower = more frequent uploads." }, "run_time": { "title": "Run Time (Minutes)", "minimum": 0, "maximum": 1440, "type": "integer", "description": "Stop after this many minutes. Applies to both recording and metadata-only mode. Set to 0 to run until the stream ends." } } }, "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 } } } } } } } } } } ```