TikTok Live Downloader

TikTok Live Downloader is a tiktok live downloader that records an active public broadcast as one-minute MP4 segments and pairs every file with room metadata, creator details, viewer metrics, and timestamped interaction events. Use it to archive a live session while preserving the structured context needed for monitoring, analysis, and downstream automation.

• Fixed one-minute MP4 output. Each completed file is uploaded to the run's default Key-Value Store and exposed as video_url.
• 62-field Dataset contract. Room, creator, audience, commerce, permission, timing, event, and provenance fields stay attached to each segment.
• Live interaction history. live_events records available comments, joins, likes, follows, shares, gifts, subscriptions, donations, emotes, envelopes, and viewer-count updates in chronological order.
• Measured daily-test workload. The one-minute prefill completed in 92.534 seconds with one Dataset row in a 512 MiB no-swap container.

A measured one-minute run billed 61 recording seconds because cumulative media duration is rounded up once. At the FREE rate, that example costs $0.05758 before Actor Usage: 61 × $0.00078 plus the $0.01 Actor Start event.

Why Choose TikTok Live Downloader

Video and structured context arrive together. The MP4 is useful for review and reuse, while room_id, room_title, author_name, current_users, and live_events preserve what happened around the recording.

Files appear incrementally. A completed one-minute segment is uploaded and published without waiting for a long broadcast to finish, which supports polling workflows and reduces the amount lost if a source later disconnects.

Engagement is queryable. Instead of extracting chat from pixels, use timestamped event objects and room counters to build moderation queues, audience timelines, or creator dashboards.

Billing follows published media duration. Segment durations accumulate before rounding, so multiple fractional segments are not each rounded up independently.

Quick Start Guide

Step 1: Configure

Open the Actor input page. The working example is prefilled; replace it with a public TikTok username, profile URL, or /live URL when needed. Set run_time to a positive minute count or use 0 to continue until the stream ends.

{
  "tiktok_url": "https://www.tiktok.com/@tv_asahi_news/live",
  "run_time": 1
}

Step 2: Run

Click Start. The target must be live and publicly reachable at run time. The Actor resolves the current room, connects to live events, records the media stream, and prepares fixed one-minute MP4 segments.

Step 3: Collect

Open Dataset for structured rows and Key-Value Store for MP4 files. A row is published only after its matching video file has been stored successfully.

Input Parameters

The Actor has two inputs: one required target and one optional duration limit. Their order and types match the input schema.

Parameter	Type	Required	Description	Example
tiktok_url	string	Yes	TikTok username, @username, profile URL, or active /live URL	https://www.tiktok.com/@tv_asahi_news/live
run_time	integer	No	Maximum duration in minutes from 0 to 720, the 12-hour run limit; 0 continues until the broadcast ends	1

Usernames may contain letters, digits, underscores, and periods. URLs from non-TikTok hosts and TikTok paths unrelated to a profile or live room are rejected before source requests begin.

Output Data Schema

Each Dataset row represents one completed MP4 segment and the live-room state associated with it. The public contract contains 62 fields.

Group	Fields
Identity	url, room_id, room_title, live_id, stream_id, app_platform
Timing and state	create_time, created_at, finish_time, scheduled_end_time, is_replay, replay, visible_type, is_age_restricted
Commerce and engagement	has_commerce, has_tiktok_shop, business_live, like_count, total_user, current_users, comment_count, share_count, follow_count, room_follows, gift_users, fan_ticket
Room features	linkmic_enabled, ktv_enabled, draw_enabled, has_quiz, live_cover, tag_list, hashtag_list
Room permissions	auth_chat, auth_gift, auth_digg, auth_share, auth_mention, auth_poll, auth_rank, auth_card
Creator and fans	top_fans, author_id, author_name, author_nickname, author_bio, author_avatar, author_verified, author_secret, author_followers, author_following, author_pay_level, author_pay_score, author_fan_ticket, author_badge_list, author_region, author_os
Media, events, provenance	language, video_url, live_events, processor, processed_at

Abbreviated illustrative item; arrays are truncated here, while real rows expose the full 62-field schema:

{
  "room_id": "7673372183743007506",
  "room_title": "Live broadcast",
  "author_name": "tv_asahi_news",
  "current_users": 6082,
  "video_url": "https://api.apify.com/v2/key-value-stores/STORE_ID/records/video20260813_163737.mp4",
  "live_events": [
    {
      "event_type": "comment",
      "timestamp": "2026-08-13T16:38:02.120Z",
      "user_name": "viewer",
      "user_nickname": "Viewer",
      "data": {"comment": "Hello"}
    }
  ],
  "processor": "https://apify.com/agentx/tiktok-live-downloader",
  "processed_at": "2026-08-13T16:38:37.000+00:00"
}

Optional source values remain empty when TikTok does not expose them. Export Dataset rows as JSON, JSONL, CSV, Excel, XML, or RSS through Apify storage endpoints.

Integration Examples

TikTok Live Downloader can run through the Apify API, SDKs, Make.com, n8n, or MCP with the same two-field input.

Actor ID

YRGOmplBi9XDJKVyV

The name form agentx/tiktok-live-downloader is also accepted where an integration supports Actor names.

HTTP

curl -X POST "https://api.apify.com/v2/acts/YRGOmplBi9XDJKVyV/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tiktok_url":"https://www.tiktok.com/@tv_asahi_news/live","run_time":1}'

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("YRGOmplBi9XDJKVyV").call(run_input={
    "tiktok_url": "https://www.tiktok.com/@tv_asahi_news/live",
    "run_time": 1,
})
items = list(client.dataset(run["defaultDatasetId"]).iterate_items())

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('YRGOmplBi9XDJKVyV').call({
  tiktok_url: 'https://www.tiktok.com/@tv_asahi_news/live',
  run_time: 1,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();

Make.com

Use the Apify Run an Actor module, paste YRGOmplBi9XDJKVyV, and send the same JSON input. Follow it with Get Dataset Items after the run completes.

n8n

Use the Apify node or an HTTP Request node with Actor ID YRGOmplBi9XDJKVyV. Poll the run status, then read the default Dataset and Key-Value Store.

MCP

Connect the official Apify MCP server, expose Actor YRGOmplBi9XDJKVyV, and call it with tiktok_url and run_time from an MCP client.

Pricing

The primary charge is one seconds event per cumulative second of published video duration. Actor Start and Actor Usage are separate registered events.

Tier	Recording second	Actor Start	Actor Usage
FREE	$0.00078	$0.01	$0.00001 per usage unit
BRONZE	$0.00077	$0.01	$0.00001 per usage unit
SILVER	$0.00076	$0.01	$0.00001 per usage unit
GOLD	$0.00075	$0.01	$0.00001 per usage unit
PLATINUM	$0.00075	$0.01	$0.00001 per usage unit
DIAMOND	$0.00075	$0.01	$0.00001 per usage unit

The Actor uses 512 MiB, so the one-time Actor Start rule charges its minimum one event. A measured one-minute test produced 60.099 seconds of media and billed 61 seconds: 61 × $0.00078 + $0.01 = $0.05758 before Actor Usage. A nominal ten-minute recording at the FREE rate is approximately 600 × $0.00078 + $0.01 = $0.47800 before Actor Usage; the measured duration can move the final second count slightly.

Prices can change. Check the live pricing page before budgeting a recurring workflow.

Use Cases

Archive a scheduled broadcast. Use video_url, room_title, author_name, and timing fields to index each one-minute file in a media library.

Build an engagement timeline. Flatten live_events and combine comment, like, follow, share, gift, and viewer-count events by their timestamps.

Monitor creator performance. Track current_users, total_user, like_count, comment_count, share_count, gift_users, and fan_ticket across successive segment rows.

Review live-commerce sessions. Filter has_commerce, has_tiktok_shop, and business_live, then pair the matching MP4 with engagement changes.

Trigger downstream media processing. Send each video_url to transcription, moderation, clipping, or storage automation as soon as its row appears.

Alternatives

Manual screen recording is reasonable for a single short session when structured metadata and automation are unnecessary. It becomes cumbersome when files need stable URLs, repeated schedules, room metrics, or machine-readable event histories.

TikTok's own app is the best place to watch and interact with a live broadcast. This Actor is better suited to an automated data pipeline; it does not replace TikTok's viewing, moderation, or creator tools.

General media utilities can save video from a supplied playback URL, but they usually do not resolve a live room or attach the 62-field TikTok room contract. Choose something else if the target is an ended VOD, a private stream, an age-gated room without an authorized session, or a non-TikTok platform.

Limits and Troubleshooting

• No row appears → the account may be offline, private, unavailable, age-restricted, or temporarily blocked. Confirm that the same public /live URL is active and viewable, then retry.
• The run stops before the requested duration → TikTok may have ended the broadcast or the media source may have closed. Inspect the run log and keep already-published rows and MP4 files.
• Some fields are empty → optional room, language, badge, tag, fan, and commerce values are source-dependent. Treat an empty value as unavailable rather than inventing a default.
• An event type is absent → live events only appear when viewers generate them and TikTok delivers them during the captured interval. A quiet segment can legitimately have an empty array.
• The billed seconds exceed the visible whole minutes → media duration is measured, accumulated, and rounded up cumulatively; container timing can be slightly above a nominal minute.

For a reproducible problem, open an Issue with the run ID, exact input, target state, and the first relevant error message. Never include tokens, cookies, or private session values.

Trust and Reliability

Apify-managed execution and storage. Runs use the Actor's declared 512 MiB memory setting, Dataset schema, and Key-Value Store video collection.

Measured runtime path. Final isolated rehearsals produced one row in 92.534 seconds and two rows in 128.878 seconds under a 512 MiB no-swap limit.

Documented 62-field contract. Output keys are fixed by the Dataset schema; signed source playback URLs remain internal and the public media field is the stored video_url.

Usage-linked billing. Recording seconds are charged only after a video segment is successfully stored and its Dataset row is published.

Legal and Compliance

Public data scope. Use the Actor only for live broadcasts you are permitted to access and record. It is designed for public TikTok Live targets, not bypassing private access controls.

Privacy responsibility. Live video and interaction events can include personal data. Define a lawful purpose, minimize retention, control access, and honor applicable deletion obligations.

Platform terms. You are responsible for complying with TikTok's terms, intellectual-property rules, and the laws that apply to recording and processing a broadcast in the relevant jurisdiction.

Frequently Asked Questions

Can this tiktok live downloader save an active broadcast?

Yes. It resolves a currently active public TikTok Live room and stores completed one-minute MP4 segments while the run remains connected.

Does it capture TikTok Live chat and gifts?

Yes, when TikTok delivers those events during the recording. The live_events array can include comments, gifts, joins, likes, follows, shares, subscriptions, donations, emotes, envelopes, and viewer-count updates.

Can I record a TikTok Live after it has ended?

No. This Actor records an active live media source; use a video downloader when you already have an accessible finished-video URL.

Why does a one-minute run bill 61 seconds?

Because billing uses measured media duration and cumulative ceiling rounding. A measured 60.099-second file produces 61 billable seconds.

Is there a free TikTok Live API?

Apify may provide platform credits or plan allowances, but this Actor uses pay-per-event pricing. Review the live pricing page and test the one-minute prefill before scheduling longer runs.

Can I schedule runs to monitor TikTok Live streams over time?

Yes. Use an Apify Schedule, but a run succeeds only when the target is actively live; stagger checks responsibly and avoid overlapping long recordings of the same account.

Do I need a TikTok password or cookie?

No input credential is required for ordinary public rooms. Private, unavailable, or age-restricted rooms can still be inaccessible.

Where are the MP4 files stored?

Each completed MP4 is stored in the run's default Key-Value Store under the video collection, and the corresponding Dataset row exposes its video_url.

Related AgentX Actors

AgentX publishes a broad catalog of Actors organized by product category. Closest to this Actor:

• TikTok Creator API — collect creator profile data without recording a live session.
• TikTok Transcript — turn a TikTok video into text instead of retaining live MP4 segments.
• Twitch VOD Downloader — save broadcast media from Twitch once a stream has ended.

Business and Market Intelligence

• Google Keyword Trends — Google Trends keyword interest, compared five at a time
• Google Trends Scraper — Google Trends trending searches
• Google Maps Store Scraper — Google Maps business listings
• LinkedIn Company Lookup — LinkedIn company records
• LinkedIn Profile Lookup — LinkedIn profile records
• Weather Forecast API — forecast and historical weather data

Jobs and Hiring

• All Jobs Scraper — multi-platform job listings
• Bayt Jobs Scraper — Bayt job listings
• Glassdoor Jobs Scraper — Glassdoor job listings
• Indeed Jobs Scraper — Indeed job listings
• JobStreet Company Profile — JobStreet employer records
• Jooble Jobs Scraper — Jooble job listings
• LinkedIn Jobs Scraper — LinkedIn job listings
• Naukri Jobs Scraper — Naukri job listings
• Talent Jobs Scraper — Talent.com job listings
• ZipRecruiter Jobs Scraper — ZipRecruiter job listings

Social Media

• Instagram Creator Scraper — Instagram creator profiles
• Instagram Reels Scraper — Instagram Reels metadata
• Instagram Trending Scraper — Instagram trending content
• Medium Scraper — Medium articles
• Medium Profile Scraper — Medium author profiles
• Reddit Profile Scraper — Reddit user profiles
• Reddit Viral Scraper — Reddit viral posts
• SubReddit Info Scraper — subreddit metadata
• Subreddit Members Scraper — subreddit member lists
• Subreddit Posts Scraper — subreddit post feeds
• Telegram Chat Scraper — Telegram chat messages
• Telegram Info Scraper — Telegram channel metadata
• Telegram Member Adder — Telegram group membership management
• Telegram Member Scraper — Telegram group members
• Telegram Private Group Scraper — private Telegram group data
• TikTok Creator API — TikTok creator profiles
• TikTok User Lookup — TikTok account records
• X Twitter Community API — X community data
• X Twitter Profile Lookup — X profile records
• YouTube Creator Email Scraper — YouTube creator contact data

Video, Transcripts and Downloads

• All Video Scraper — multi-platform video metadata
• Video Transcript — multi-platform transcripts
• Video Captions Downloader — caption files
• Video to Social Post — video repurposed into social copy
• YouTube Transcript — YouTube transcripts
• TikTok Transcript — TikTok transcripts
• X Twitter Transcript — X video transcripts
• Facebook Transcript — Facebook video transcripts
• Bilibili Transcript — Bilibili transcripts
• Dailymotion Transcript — Dailymotion transcripts
• Rutube Transcript — Rutube transcripts
• Loom Transcript — Loom transcripts
• Wistia Transcript — Wistia transcripts
• Instagram Reels Downloader — Reels downloads
• Kick Clip Downloader — Kick clip downloads
• Linkedin Video Downloader — LinkedIn video downloads
• Pinterest Video Downloader — Pinterest video downloads
• Reddit Video Downloader — Reddit video downloads
• Snapchat Video Downloader — Snapchat video downloads
• TED Talk Downloader — TED talk downloads
• Twitch VOD Downloader — Twitch VOD downloads
• Zoom Recording Downloader — Zoom recording downloads

E-Commerce and Retail

• All Shopping Scraper — multi-platform product data
• AliExpress Product Scraper — AliExpress products
• Amazon Storefront Scraper — Amazon Brand Store pages
• Bol Product Scraper — Bol.com products
• eBay Seller Leads API — eBay seller records
• Hepsiburada Product Scraper — Hepsiburada products
• Kakaku Product Scraper — Kakaku.com products
• Rakuten Product Scraper — Rakuten products

Classifieds and Automotive

• All Vehicle Scraper — multi-platform vehicle listings
• AutoTrader Vehicle Search — AutoTrader US listings
• AutoTrader UK Vehicle Search — AutoTrader UK listings

Real Estate

• All Property Scraper — multi-platform property listings
• Homes Property Scraper — Homes.com listings
• MagicBricks Property Scraper — MagicBricks listings
• NoBroker Property Scraper — NoBroker listings
• Property24 Property Scraper — Property24 listings
• Realtor Property Scraper — Realtor.com listings
• Zillow Property Scraper — Zillow listings

Support and Community

Ask about TikTok Live recording, MP4 output, room metrics, or event fields in the AgentX community on Telegram; for a reproducible bug, open an Issue with the run ID and the exact input.

AgentX is an Arcyton brand — arcyton.com.

Last Updated: August 13, 2026