TikTok Live Recorder

TikTok Live Recorder is a tiktok live recorder that saves an active public broadcast as one-minute MP4 files and returns room metadata, audience metrics, creator details, and timestamped interaction events for developers and data teams.

• One file and one structured row per completed segment.
• 62 documented Dataset fields plus MP4 files in the default Key-Value Store.
• Comments, joins, likes, follows, shares, gifts, subscriptions, donations, emotes, envelopes, and viewer updates are captured when TikTok delivers them.
• The two-minute prefilled rehearsal completed in 128.878 seconds and returned two Dataset rows.

Run the two-minute test · View API

The smallest prefilled test records two minutes and costs about $0.07897 before Actor Usage at the FREE rate when measured media duration bills 121 seconds: 121 × $0.00057 + $0.01.

What does TikTok Live Recorder do?

TikTok Live Recorder connects to a currently active public TikTok Live room, records the media stream, and uploads fixed one-minute MP4 segments. After a segment is safely stored, the Actor publishes a matching Dataset row with the room snapshot and events accumulated during that interval.

This is not a downloader for ended TikTok posts or inaccessible replays. It does not unlock private broadcasts, replace TikTok's viewer or creator tools, or guarantee that optional room attributes will be present. The target must be live and publicly reachable when the run starts.

The output is designed for automation. video_url is a durable link to the stored file, while identifiers, timestamps, creator fields, engagement counters, commerce flags, permissions, and live_events make each segment searchable without analyzing video pixels.

How do I run TikTok Live Recorder?

1. Open TikTok Live Recorder and choose Try for free.
2. Enter a public TikTok username, profile URL, or /live URL in tiktok_url.
3. Set run_time to the maximum number of minutes, or use 0 to continue until the broadcast ends.
4. Start the run, then open Dataset for JSON rows and Key-Value Store for MP4 files.

The prefilled input is a small, measured rehearsal:

{
  "tiktok_url": "https://www.tiktok.com/@gbnews/live",
  "run_time": 2
}

The result limit is time-based rather than item-based. The Actor normally publishes one row per completed one-minute media segment, so a two-minute run typically returns two rows when the source stays live.

What data does TikTok Live Recorder return?

Every row represents one completed MP4 segment and contains 62 public fields. Values that TikTok does not expose remain empty instead of being guessed.

Group	Public fields
Room identity	url, room_id, room_title, live_id, stream_id, app_platform
Time and visibility	create_time, created_at, finish_time, scheduled_end_time, is_replay, replay, visible_type, is_age_restricted
Commerce and counts	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, language
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
File, events, provenance	video_url, live_events, processor, processed_at

Abbreviated illustrative item; the full row follows the 62-field schema and event arrays can contain many objects:

{
  "room_id": "7673052046974634774",
  "room_title": "Watch live",
  "author_name": "gbnews",
  "current_users": 2932,
  "video_url": "https://api.apify.com/v2/key-value-stores/STORE_ID/records/video20260813_163714.mp4",
  "live_events": [
    {
      "event_type": "viewer_count",
      "timestamp": "2026-08-13T16:38:00.000Z",
      "data": {"online": 2932, "total": 18400}
    }
  ],
  "processed_at": "2026-08-13T16:38:14.000+00:00"
}

What inputs can I configure?

The Actor exposes exactly two inputs in schema order.

Input	Type	Required	Behavior
tiktok_url	string	Yes	Accepts a username, @username, TikTok profile URL, or TikTok /live URL
run_time	integer	No	Maximum duration from 0 to 1440 minutes; 0 runs until the live stream ends

The prefill uses https://www.tiktok.com/@gbnews/live and run_time: 2. A foreign domain, unrelated TikTok path, blank username, boolean duration, fractional duration, negative duration, or value above 1440 is rejected before recording begins.

What platforms and markets does TikTok Live Recorder cover?

TikTok Live Recorder supports public TikTok Live broadcasts. It does not fan out to YouTube Live, Twitch, Instagram Live, or other platforms. Use the matching platform-specific Actor when the source is not TikTok.

There is no country input or market filter. Coverage depends on whether TikTok exposes the public room and media stream from the run's route. Language, creator region, tags, badges, gift rankings, and commerce attributes are source-dependent and may be empty even when video recording succeeds.

Usernames, profile URLs, and live URLs all resolve to the same current room for an active account. The Actor records the available stream quality selected by the source client; it does not expose a public quality switch.

Why use TikTok Live Recorder?

Capability	Benefit
Incremental one-minute MP4 storage	Poll and process completed files before a long broadcast ends
62-field room and creator contract	Join media to stable IDs, source timestamps, metrics, and profile context
Chronological live_events	Analyze available chat and engagement without optical or audio extraction
Commerce and permission flags	Segment shopping sessions and understand which interactions the room allows
Cumulative duration billing	Avoid independently rounding every fractional media segment

The main trade-off is that live sources are volatile. A target can go offline, restrict access, close its media connection, or stop emitting a particular event at any point. Design downstream jobs to keep already-published segments and treat optional fields as nullable.

Who is TikTok Live Recorder for?

The Actor is primarily for developers and data teams that need both live video and structured TikTok context.

• Media operations teams can archive public broadcasts and index files by room_id, author_name, and processed_at.
• Social analytics teams can track viewer, share, comment, follow, gift, and fan-ticket changes across segments.
• Live-commerce researchers can filter has_commerce, has_tiktok_shop, and business_live while retaining the matching video.
• Moderation and research workflows can transform live_events into a timestamped activity table.
• Automation builders can send each video_url into transcription, clipping, storage, or review systems.

Choose another tool if you only need a finished TikTok post, a transcript without MP4 retention, a private-room workflow, or a multi-platform live recorder.

How can I use TikTok Live Recorder through the API or MCP?

The real Actor ID is fN4fJgXUfEbeYjNxL; the name form truefetch/tiktok-live-recorder is also supported by clients that accept Actor names.

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

The response contains the run ID and default storage IDs. Poll the run endpoint until it reaches a terminal state, then read Dataset items and Key-Value Store records through the generated endpoints on the API page.

For MCP, connect the official Apify MCP server, expose Actor fN4fJgXUfEbeYjNxL, and call it with the same JSON input. An MCP client can start the run and work with the structured Dataset response; use Apify storage URLs when a workflow needs the MP4 binary.

How much does TikTok Live Recorder cost?

The FREE price is $0.00057 per cumulative recording second, and the smallest prefilled two-minute test measured 121 billed seconds for a $0.07897 total before Actor Usage, including the $0.01 Actor Start event.

Tier	Recording second	Actor Start	Actor Usage
FREE	$0.00057	$0.01	$0.00001 per usage unit
BRONZE	$0.00055	$0.01	$0.00001 per usage unit
SILVER	$0.00053	$0.01	$0.00001 per usage unit
GOLD	$0.00051	$0.01	$0.00001 per usage unit
PLATINUM	$0.00051	$0.01	$0.00001 per usage unit
DIAMOND	$0.00051	$0.01	$0.00001 per usage unit

Recording durations accumulate before ceiling rounding. The final rehearsal produced files of 60.065 and 60.100 seconds, so 120.165 total seconds became 121 billable seconds: 121 × $0.00057 + $0.01 = $0.07897 before Actor Usage. Prices can change; verify the current pricing page.

How does TikTok Live Recorder compare with alternatives?

Manual screen recording works for a one-off personal review when you do not need structured metrics, event objects, stable storage URLs, or automation. TikTok's official app is better for watching, interacting, moderating, and using creator-native features.

A separate media recorder can save an already-resolved playback URL, but it does not necessarily resolve a TikTok account's current room or preserve creator, audience, permission, commerce, and event context. General social analytics products may provide dashboards, while this Actor returns raw files and rows for your own pipeline.

Choose TikTok Live Recorder when an active public TikTok broadcast, incremental MP4 output, and a documented Dataset contract are all required. Choose something else for ended posts, private access, non-TikTok streams, metadata-only monitoring, or guaranteed capture of events that do not occur during the run.

What are the limits and troubleshooting steps?

• No Dataset row → confirm the target is actively live and public. Offline, private, unavailable, or age-restricted rooms may not resolve.
• Recording ends early → the broadcaster or media source may have ended. Keep previously published rows and inspect the first run error.
• An optional field is empty → TikTok did not expose that attribute for the room. Do not substitute a value from another account or run.
• live_events is empty or lacks gifts → the event must occur and be delivered during that segment. A quiet room can legitimately produce no event of a given type.
• Billed seconds are one above a whole minute → actual media duration can slightly exceed the nominal segment target and cumulative duration is rounded up.
• A retry gives a different room ID → the creator may have started a new live session; use room_id and stream_id as session identities.

The smallest reproducible input is the two-field prefill shown in this README. When requesting help, include the run ID, exact public input, whether the target was live, and the first relevant error. Never share an API token or private session value.

Frequently asked questions

Can a tiktok live recorder save video and chat together?

Yes. Every completed MP4 segment receives a matching Dataset row with room context and the available events accumulated during that interval.

Can I download a TikTok Live after it ends?

No. This Actor records an active public media source; use a finished-video downloader when an accessible post or replay URL already exists.

Why are some creator or room fields empty?

Because TikTok does not expose every optional attribute on every room. Region, language, tags, badges, fan rankings, and commerce fields are preserved only when present.

Does the Actor require my TikTok login?

No public input asks for a TikTok credential. Public rooms normally work without one, while private, unavailable, or age-restricted rooms may remain inaccessible.

How often is a video file published?

Approximately once per completed minute of media. Source timing and keyframe boundaries can make measured file duration slightly different from exactly 60.000 seconds.

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

Yes. Use Apify Schedules, but each run only records while the account is actively live; avoid overlapping recordings for the same target.

Is there a free TikTok Live API?

Apify plan credits may offset test usage, but this Actor has pay-per-event pricing. Use the two-minute prefill to measure current availability and cost before a longer schedule.

Where are recorded files stored?

MP4 files are stored in the run's default Key-Value Store, and each matching Dataset row contains the public video_url returned after upload.

Related TrueFetch Actors

• TikTok Video Downloader — download accessible finished TikTok videos rather than active broadcasts.
• Video To Text — convert saved or online video into transcript text for search and review.
• Social Media Marketing — turn media into channel-specific post drafts after recording.

Support

Use the Store page to run the Actor, the API page for generated integration details, and the Issues page for reproducible failures. Product questions and updates belong in the TrueFetch community.

Run a measured recording · Open the API reference

Last Updated: August 13, 2026