TikTok Live Recorder

TikTok Live Recorder at a glance

TikTok Live Recorder is a ready-to-run Apify actor from abotapi for collecting social media data. Its documented output includes username, room id, status, room title and duration (s), which you can export as JSON, CSV or Excel or read through the Apify API. It costs $1.70 per 1,000 recording seconds on the Apify Free plan and from $1.00 on paid plans, with smaller per-run or optional feature charges listed on Apify.

Runs on: Apify cloud: console, API, schedules and integrations
Data type: Social Media, Videos, MCP servers
Pricing: $1.70 per 1,000 recording seconds (Free plan), from $1.00 on paid plans
Output: Documented below · JSON, CSV, Excel
Inputs: 8 options
Run success: 95.7% of completed public runs in the last 30 days

Record TikTok LIVE streams to MP4 at a fraction of the cost. Extract full stream metadata and all available quality URLs. Supports crash-resilient segmented recording for reliable video capture and recovery.

What TikTok Live Recorder can do

Three ways to start a recording. Give it a username, a room ID, or a live URL. No login is required for a public stream.
A real MP4 file, not just metadata. The captured stream converts automatically into a playable video, alongside every quality-level stream URL TikTok exposes.
Crash-resilient segmented recording. Split a long broadcast into timed chunks that each convert and upload as soon as they finish, so an interrupted run still leaves you with what was captured.
Duration on your terms. Stop after a fixed number of seconds, or keep recording until the broadcast itself ends.
Rich stream intelligence with every recording. Viewer counts, total viewers, likes, creator profile, commerce and replay flags come back alongside the file.

Choose what to collect

These inputs let you configure TikTok Live Recorder - MP4 Videos, Metadata & Stream URLs. Open the actor on Apify to enter your values and review the current options.

Supported input fields
Input	What it controls
`username`string	TikTok username to record. Accepts 'user', '@user', or a pasted profile / live link. Provide at least one of: username, Room ID, or Live URL. The sample value 'tiktok' is only used when Room ID and Live URL are empty.
`roomId`string	TikTok live room ID. Use this if username resolution is blocked by TikTok's WAF.
`liveUrl`string	TikTok live or profile URL (e.g. https://www.tiktok.com/@user/live). Desktop, mobile (m.tiktok.com) and short (vm./vt.tiktok.com) links are accepted. Provide at least one of: username, Room ID, or Live URL. The sample link is only used when Username and Room ID are empty.
`duration`integer	Maximum recording duration in seconds. Set to 0 to record until the stream ends.
`segmentDuration`number	Split recording into segments of this length (in minutes). Each segment is converted and uploaded immediately, so partial recordings survive crashes. Set to 0 or leave empty for a single file.
`mcpConnectors`array	Optionally send the result record into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify, Settings, API & Integrations, then select it here. Notion gets a rich page export; other connectors get a best-effort write or digest. Leave empty to skip; never changes the dataset output.
`notionParentPageUrl`string	URL or id of the Notion page under which result pages are created. Required to enable the Notion export; ignored by other connectors.

Show 1 more input

More input fields
Input	What it controls
`maxNotifyListings`integer	Cap on result records written to each connector per run. Does not affect the dataset.

Fields in the output

The documented dataset includes the fields below. Availability can depend on the source page and selected mode.

usernameUsername

roomIdRoom ID

statusStatus

roomTitleRoom Title

durationSecondsDuration (s) (number)

fileKeyFile Key

fileSizeBytesSize (bytes) (number)

viewerCountViewers (number)

likeCountLikes (number)

startedAtStarted

endedAtEnded

totalViewersTotal Viewers (number)

Show 25 more fields

hasCommerceCommerce

isReplayReplay

authorAuthor

streamUrlsStream URLs

segmentsSegments

author_idAuthor ID

author_nameAuthor Name

author_nicknameNickname

author_bioBio

author_avatarAvatar

author_verifiedVerified

author_followersFollowers (number)

author_followingFollowing (number)

author_regionRegion

author_pay_levelPay Level (number)

author_fan_ticketFan Tickets (number)

current_usersCurrent Users (number)

comment_countComments (number)

share_countShares (number)

follow_countFollows (number)

gift_usersGift Users (number)

fan_ticketFan Tickets (number)

segments.segmentIndexSegment (number)

segments.fileKeyFile Key

segments.fileSizeBytesSize (bytes) (number)

Example output

An example from this actor’s documentation. Values are illustrative; this is not a fresh live result.

{
  "username": "sampleuser",
  "roomId": "7348921047128372224",
  "startedAt": "2026-02-27T12:00:00.000000+00:00",
  "endedAt": "2026-02-27T12:05:30.000000+00:00",
  "durationSeconds": 330.5,
  "fileKey": "TK_sampleuser_1772193600.mp4",
  "fileSizeBytes": 52428800,
  "status": "completed",
  "roomTitle": "Sample live session",
  "viewerCount": 1523,
  "totalViewers": 8420,
  "likeCount": 34500,
  "hasCommerce": false,
  "isReplay": false,
  "author": {
    "id": "6812345678",
    "uniqueId": "sampleuser",
    "nickname": "Sample User",
    "avatarUrl": "https://example.tiktokcdn.com/avatar.jpg",
    "followerCount": 155000000,
    "isVerified": true,
    "region": "US"
  },
  "streamUrls": [
    {
      "quality": "Origin",
      "level": 4,
      "url": "https://example-cdn.tiktokcdn.com/stream-origin.flv"
    },
    {
      "quality": "HD",
      "level": 2,
      "url": "https://example-cdn.tiktokcdn.com/stream-hd.flv"
    }
  ]
}

Ways to use this data

Archiving and moderation: keep a permanent MP4 record of a creator's live broadcasts for compliance or moderation review.
Highlight and clip creation: pull the recording and its stream metadata to cut highlights for social or marketing use.
Fan and community tools: build a "is this creator live right now" alert or highlight feed from the viewer count, likes and commerce flags.
Scheduled monitoring: run the actor on a schedule against a creator who streams irregularly, and only pay for the seconds actually captured.
Research and analytics: track viewer counts, total viewers and engagement across multiple creators over time.

Before you run

Start with a small input and check the resulting records against your expected fields. Source content and actor options can change; the current Apify listing is the reference for availability and pricing.

Questions about this actor

What data does TikTok Live Recorder return?

The documented output for TikTok Live Recorder includes username, room id, status, room title, duration (s), file key, size (bytes) and viewers. Availability of each field depends on the source page and the selected mode.

How much does TikTok Live Recorder cost?

It costs $1.70 per 1,000 recording seconds on the Apify Free plan and from $1.00 on paid plans, with smaller per-run or optional feature charges listed on Apify. The Apify listing shows the current rate for every plan.

Why did my run finish with status "not_live" and no recording?

The creator was not live when the run started. The run still ends SUCCEEDED and pushes one record with status: "not_live", whereas a run that could not read anything, or captured no data, ends FAILED. not_live is not an error: username resolution and the live check both succeeded, there is simply nothing to record right now. Schedule the actor to run periodically if you want to catch the next broadcast automatically.

Can I split a long recording so I don't lose it if the run crashes?

Yes. Turn on segmentDuration (in minutes). Each segment converts to MP4 and uploads to the Key-Value Store as soon as it finishes, so a crash or timeout only costs you the segment in progress, not the whole recording.

Can I use it with AI agents or MCP?

Yes. Call it from any Apify integration or MCP client. The dataset row returns the file key, and the MP4 downloads from the run's Key-Value Store.