TikTok Live Downloader avatar

TikTok Live Downloader

Pricing

from $0.75 / 1,000 recording seconds

Try for free
Go to Apify Store
TikTok Live Downloader

TikTok Live Downloader

Try for free

Connect to any TikTok Live URL and either record the broadcast in segmented MP4 chunks pushed to your key-value store, or stream pure metadata events — comments, gifts, likes, follows, viewer count — in near real time. Configurable upload interval and max run length up to 24 hours.

Pricing

from $0.75 / 1,000 recording seconds

Rating

5.0

(3)

Developer

AgentX

AgentX

Maintained by Community

Actor stats

2

Bookmarked

56

Total users

4

Monthly active users

5 days ago

Last modified

Categories

Social media

Videos

Developer tools

Share

TikTok Live Downloader - TikTok Live Stream Intelligence API

TikTok Live Downloader is a TikTok live-stream intelligence API that captures real-time viewer counts, engagement metrics, gift events, top-fan monetization signals, and TikTok Shop status from any live stream in a single username/room-driven run, with optional video segment recording. TikTok Live Downloader returns structured records per stream, including stream ID, room title, current_users, total_user, fan_ticket, gift_users, top_fans array, has_tiktok_shop flag, business_live flag, streamer username, streamer follower count, streamer profile image, stream start timestamp, stream end timestamp, chronological live_events array (comments, gifts, likes with sender and timestamp), live cover image URL, and optional recorded video segment URLs. Coverage spans all public TikTok live streams globally with optional video recording. Built for influencer marketing analytics, e-commerce live-shopping intelligence, competitor monitoring, creator dashboard pipelines, brand-sponsorship attribution, and TikTok Shop conversion-research workflows. Per-stream pay-per-result pricing at $0.00077 with no monthly minimum.

TikTok Live Live Stream Intelligence Real-Time Metrics

Why Choose This API

Structured TikTok Live Data for Real-Time Marketing Pipelines

📊 Real-Time Viewer & Engagement Metrics The current_users, total_user, like_count, comment_count, share_count, and follow_count fields capture live session engagement — enabling real-time audience sizing, peak viewer analysis, and creator performance benchmarking across competitive intelligence pipelines.

🎁 Gift & Monetization Intelligence The gift_users, fan_ticket, top_fans, author_pay_level, and author_pay_score fields expose live monetization signals per session — enabling creator revenue estimation, top-spender identification, and gift engagement analytics for brand partnership valuation.

🛒 TikTok Shop & E-Commerce Detection The has_commerce, has_tiktok_shop, and business_live fields identify commerce-enabled live streams — enabling e-commerce live stream monitoring, TikTok Shop seller intelligence, and brand integration opportunity detection.

📋 Chronological Live Event Log The live_events array captures every comment, gift, like, and share event in order — delivering timestamped live chat archives for sentiment analysis, audience behavior studies, and engagement pattern extraction.

🎥 Optional Video Segment Recording Enable record_video to record and upload video segments to Apify Key-Value Store as video_url — enabling stream archival, content monitoring, and downstream video processing pipelines.

Quick Start Guide

How to Monitor a TikTok Live Stream in 3 Steps

Step 1: Enter the Live Stream URL

Open Actor Input

Paste the TikTok live stream URL (e.g., https://www.tiktok.com/@creator/live).

Step 2: Configure Recording and Duration

Set record_video (enable for video segments, disable for metadata-only), upload_every (segment interval in minutes), and run_time (0 = capture until stream ends).

Step 3: Access Structured Live Intelligence

Results are pushed to the dataset at each interval. Download as JSON or CSV, or poll via the Apify dataset API during the live run.

Input Parameters

Configuration Fields

ParameterTypeRequiredDescriptionExample Values
tiktok_urlstring✅TikTok live stream URL"https://www.tiktok.com/@creator/live"
record_videoboolean✅Enable video segment recording; disable for metadata-onlyfalse, true
upload_everynumber❌Segment/push interval in minutes (1–60)1, 5, 10
run_timeinteger❌Maximum run duration in minutes (0 = until stream ends, max 1440)0, 30, 60

Example Input — Metadata Only (Faster & Lower Cost)

{
  "tiktok_url": "https://www.tiktok.com/@tv_asahi_news/live",
  "record_video": false,
  "upload_every": 5,
  "run_time": 30
}

Example Input — With Video Recording

{
  "tiktok_url": "https://www.tiktok.com/@creator/live",
  "record_video": true,
  "upload_every": 10,
  "run_time": 60
}

Output Data Schema

Complete Live Stream Record Structure

Each dataset record represents one monitoring interval snapshot containing:

Open Actor Output

Stream Metadata Fields

FieldTypeDescription
processorstringApify actor URL that processed this record
processed_atstringISO 8601 timestamp (UTC) when pushed
room_idstringUnique live room identifier
room_titlestringStream title set by the creator
live_idintegerInternal TikTok live session ID
stream_idstringCurrent stream session identifier
app_platformstringStreaming platform (ios/android/pc/web)
created_atstringISO 8601 stream start timestamp
finish_timeintegerUnix timestamp when stream ended
languagestringPrimary stream language code
visible_typestringVisibility (public/private/followers_only etc.)
is_replaybooleanReplay of past stream flag
is_age_restrictedbooleanAge restriction flag
tag_listarrayCreator-attached stream tags
hashtag_listarrayStream hashtags
live_coverstringLive stream cover image URL

Engagement & Monetization Fields

FieldTypeDescription
like_countintegerTotal stream likes
total_userintegerTotal unique viewers
current_usersintegerCurrent live viewer count
enter_usersintegerTotal users who entered the room
comment_countintegerTotal comments posted
share_countintegerTotal shares
follow_countintegerNew follows gained during stream
room_followsintegerDirect room follows
gift_usersintegerUnique gift senders count
fan_ticketintegerTotal fan tickets collected
top_fansarrayTop fans ranked by gift contribution

Commerce & Feature Flags

FieldTypeDescription
has_commercebooleanCommerce/shopping features enabled
has_tiktok_shopbooleanTikTok Shop integration active
business_livestringStream category (normal/business/ecommerce)
linkmic_enabledbooleanLink mic co-streaming enabled
auth_chatbooleanChat enabled
auth_giftbooleanGift sending enabled
auth_pollbooleanPoll feature enabled

Streamer Profile Fields

FieldTypeDescription
author_idstringStreamer unique identifier
author_namestringStreamer @username
author_nicknamestringStreamer display name
author_biostringStreamer profile bio
author_verifiedbooleanVerified status
author_followersintegerFollower count
author_pay_levelintegerTikTok pay grade level
author_pay_scoreintegerAccumulated payment score
author_fan_ticketintegerTotal fan tickets received
author_regionstringStreamer geographic region
author_badge_listarrayAchievement badges

Event & Recording Fields

FieldTypeDescription
live_eventsarrayChronological comment/gift/like/share event log
video_urlstringRecorded video segment URL (if recording enabled)

Example JSON Output

{
  "processor": "https://apify.com/agentx/tiktok-live-downloader?fpr=aiagentapi",
  "processed_at": "2026-05-01T10:35:00.000Z",
  "room_id": "7234567890123456789",
  "room_title": "Breaking News Live",
  "created_at": "2026-05-01T10:00:00+00:00",
  "language": "en",
  "current_users": 1250,
  "total_user": 18400,
  "like_count": 5240,
  "comment_count": 890,
  "gift_users": 67,
  "fan_ticket": 4200,
  "has_tiktok_shop": false,
  "business_live": "normal",
  "author_name": "tv_asahi_news",
  "author_verified": true,
  "author_followers": 850000,
  "live_events": [
    {
      "event_type": "comment",
      "timestamp": "2026-05-01T10:31:00.000Z",
      "user_name": "viewer1",
      "data": { "comment": "Hello everyone!" }
    }
  ]
}

Export Formats

  • JSON - Complete structured live intelligence data
  • CSV - Spreadsheet-compatible for analytics
  • API Access - Programmatic access via Apify Client SDK
  • Cloud Storage - Automatic upload to Apify Dataset + Key-Value Store for video segments

Integration Examples

Actor ID for Platform Integration

YRGOmplBi9XDJKVyV

Ⓜ️ Make.com Setup:

  1. Login to Make.com (Get 1000 Free Credits)
  2. Add module "Run an Actor"
  3. Turn 'Map' on - right side of the 'Actor*'
  4. Paste Actor ID - from above
  5. Click the '⟳ Refresh' - left side of Map
  6. Input JSON* - Modify the parameters as needed
  7. Set "Run synchronously" to YES
  8. Add module "Get Dataset Items" - receive the result
  9. In Dataset ID* select defaultDatasetId

🎱 N8N.io Setup:

  1. Add 'Run an Actor and get dataset' - from the apify node
  2. Actor → By ID → Paste Actor ID - from above
  3. Input JSON - Modify the parameters as needed

Python Integration Example

from apify_client import ApifyClient


client = ApifyClient('YOUR_API_TOKEN')


run_input = {
    "tiktok_url": "https://www.tiktok.com/@creator/live",
    "record_video": False,
    "upload_every": 5,
    "run_time": 30
}


run = client.actor("YRGOmplBi9XDJKVyV").call(run_input=run_input)


for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

JavaScript/Node.js Integration

import { ApifyClient } from "apify-client";


const client = new ApifyClient({ token: "YOUR_API_TOKEN" });


const input = {
  tiktok_url: "https://www.tiktok.com/@creator/live",
  record_video: false,
  upload_every: 5,
  run_time: 60,
};


const run = await client.actor("YRGOmplBi9XDJKVyV").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();


items.forEach((item) => console.log(item));

JSON-LD Metadata

{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "SoftwareApplication",
      "@id": "https://apify.com/agentx/tiktok-live-downloader#software",
      "name": "TikTok Live Downloader",
      "description": "TikTok Live Downloader is a TikTok live stream intelligence API capturing real-time viewer counts, engagement metrics, gift events, monetization signals, TikTok Shop status, and chronological live event logs with optional video recording for creator monitoring and e-commerce intelligence.",
      "applicationCategory": "BusinessApplication",
      "applicationSubCategory": "Web Scraping API",
      "operatingSystem": "Web, Cloud",
      "url": "https://apify.com/agentx/tiktok-live-downloader?fpr=aiagentapi",
      "softwareVersion": "1.0.0",
      "datePublished": "2024-08-01",
      "dateModified": "2026-05-01",
      "featureList": [
        "Real-time current_users and total_user counts",
        "Gift events, fan_ticket, and top_fans",
        "TikTok Shop and business_live flags",
        "Chronological live_events log (comments/gifts/likes)",
        "Streamer profile and follower count",
        "Optional recorded video segment URLs",
        "Per-stream pay-per-result at $0.00077",
        "Native integrations with Make.com, n8n, LangChain, and CrewAI"
      ],
      "offers": {
        "@type": "Offer",
        "price": "0.00077",
        "priceCurrency": "USD",
        "availability": "https://schema.org/InStock"
      },
      "author": { "@id": "https://apify.com/agentx#person" },
      "publisher": { "@id": "https://apify.com#organization" }
    },
    {
      "@type": "Person",
      "@id": "https://apify.com/agentx#person",
      "name": "AgentX",
      "url": "https://apify.com/agentx",
      "sameAs": [
        "https://apify.com/agentx",
        "https://t.me/AiAgentApi",
        "https://t.me/Apify_Actor"
      ],
      "knowsAbout": [
        "web scraping",
        "TikTok Live",
        "live stream intelligence",
        "e-commerce live shopping",
        "creator monitoring"
      ]
    },
    {
      "@type": "BreadcrumbList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "name": "Apify",
          "item": "https://apify.com"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "name": "AgentX",
          "item": "https://apify.com/agentx"
        },
        {
          "@type": "ListItem",
          "position": 3,
          "name": "TikTok Live Downloader",
          "item": "https://apify.com/agentx/tiktok-live-downloader"
        }
      ]
    }
  ]
}

Pricing & Cost Calculator

Pay-Per-Second Pricing

EventRate
Actor Start$0.00005 per GB memory
Actor Usage$0.00001 per resource unit
Recording Seconds (video on)$0.00077 per second (BRONZE)
Metadata Seconds (video off)$0.00143 per second (BRONZE)

Cost Calculator Examples

ModeDurationEstimated Cost
Metadata only5 minutes~$0.04
Metadata only30 minutes~$0.26
Metadata only1 hour~$0.51
Video recording5 minutes~$0.23
Video recording30 minutes~$1.39
Video recording1 hour~$2.77

Use Cases & Applications

Creator Marketing Intelligence

Live Competitor Monitoring Monitor competitor creator streams in real-time — capturing peak viewer counts, engagement rates, gift monetization levels, and TikTok Shop activity to benchmark creator performance and identify partnership opportunities.

Influencer Monetization Benchmarking The fan_ticket, gift_users, author_pay_level, author_pay_score, and top_fans fields deliver per-session monetization intelligence — enabling creator revenue estimation, gift engagement scoring, and fan value analysis for influencer marketing valuations.

E-Commerce & Retail Intelligence

TikTok Shop Live Intelligence The has_tiktok_shop and business_live flags identify active commerce streams — enabling e-commerce competitor monitoring, product launch intelligence, and live-selling trend analysis for retail and brand strategy pipelines.

Live Event Stream for Sentiment Analysis The live_events array captures chronological comments and reactions — feeding structured live chat into NLP pipelines for real-time product sentiment, audience reaction scoring, and brand mention detection during live commerce events.

FAQ

What is the difference between metadata mode and video recording mode?

Metadata mode (record_video: false) collects room info, viewer counts, engagement metrics, and the live event log (comments, gifts, likes) without video. Video recording mode additionally saves video segments to the Key-Value Store as video_url. Metadata mode consumes fewer compute resources.

Can I monitor a stream continuously until it ends?

Yes — set run_time: 0 to run until the stream ends naturally. The actor monitors the stream and stops automatically when it ends. Use run_time to set a hard cap in minutes if needed.

How does upload_every affect data collection?

In metadata mode, data is pushed to the dataset every upload_every minutes — lower values give more granular time-series snapshots. In recording mode, it controls the video segment length uploaded to Key-Value Store.

Can I use this for replays?

The is_replay field indicates if the captured session is a replay. Replay monitoring is supported for metadata collection.

SEO Keywords & Search Terms

Primary Keywords

TikTok live scraper API, TikTok live stream data extraction, TikTok live viewer count API, TikTok live intelligence pipeline, TikTok live gift metrics API, TikTok live monetization data, TikTok live downloader API, TikTok live stream monitoring API, TikTok creator live analytics, TikTok live event log API

Long-Tail Keywords

how to extract TikTok live stream data programmatically, TikTok live viewer count extraction API, TikTok live gift and fan ticket data pipeline, TikTok TikTok Shop live commerce monitor, TikTok live comment sentiment analysis pipeline, TikTok live stream metadata extraction API, TikTok live competitor monitoring tool, TikTok live video recording API, TikTok live influencer analytics pipeline, TikTok live e-commerce intelligence API

Industry Terms

TikTok live stream intelligence API, real-time viewer metrics, gift monetization signals, live event log extraction, TikTok Shop live detection, creator monetization benchmarking, live commerce intelligence, fan ticket analytics, live chat sentiment pipeline, creator performance benchmarking API

Trust & Certifications

  • ✅ Production-Grade Infrastructure — runs on the Apify cloud platform with managed proxy rotation and automatic retries
  • ✅ GDPR & CCPA-Region Aligned — captures only publicly available TikTok live-stream data; no personal contact data retained beyond the run session
  • ✅ Pay-Per-Result Billing — transparent $0.00077 per stream with no monthly minimum or seat fees
  • ✅ Continuously Maintained — schema and selector updates released as TikTok evolves

Data Rights & Usage

All data extracted by this actor originates from publicly accessible TikTok live streams. Users are responsible for ensuring their use of extracted data complies with applicable laws, data protection regulations, and TikTok's terms of service.

Privacy Compliance

  • GDPR: Compliant with EU GDPR for data processing workflows.
  • CCPA: Compliant with California Consumer Privacy Act requirements.

Platform Terms of Service

Users must review and comply with TikTok's terms of service when using extracted data.

Enterprise Support

For enterprise licensing, custom integrations, or compliance inquiries:

Jobs & Hiring

Social Media

Video & Transcript

E-Commerce & Retail

Classifieds & Automotive

Real Estate

Business Intelligence & Reviews

Other

Support & Community

Last Updated: May 01, 2026

You might also like

TikTok LIVE Scraper avatar

TikTok LIVE Scraper

easyapi/tiktok-live-scraper

Extract real-time data from TikTok live streams based on search keywords. Get comprehensive information including viewer counts, stream URLs, and broadcaster details. Perfect for market research, content analysis, and monitoring live streaming trends. 🎥

User avatar

EasyApi

336

5.0

TikTok Live Recorder avatar

TikTok Live Recorder

truefetch/tiktok-live-recorder

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.

User avatar

TrueFetch

778

3.9

TL

TikTok Live Recorder — Unlimited

ben-belaouedj/tiktok-live-recorder

Monitor multiple TikTok accounts 24/7. Auto-launch Comments & Recorder the moment any stream goes live. Unlimited. Cookies supported.

User avatar

Ben Belaouedj

30

Tiktok Live Scraper avatar

Tiktok Live Scraper

coregent/tiktok-live-scraper

Extract active and trending TikTok live rooms, creator info, and public audience signals for creator monitoring, event tracking, and live trend analysis.

User avatar

Delowar Munna

11

Tiktok Live Recorder avatar

Tiktok Live Recorder

abotapi/tiktok-live-recorder

Record TikTok live streams to MP4 with full metadata, all stream quality URLs, and crash-resilient segmented recording, at a fraction of the cost.

User avatar

AbotAPI

23

Snapchat Scraper Pro avatar

Snapchat Scraper Pro

alien_force/snapchat-scraper-pro

A robust Snapchat scraper that collects Spotlights, Lenses, Stories, Users, Popular Accounts and profile statistics. Perfect for analyzing creator performance, tracking engagement, and gathering marketing insights. Reliable and efficient for all your Snapchat data needs.

User avatar

Alien Force

201

TikTok Story Viewer avatar

TikTok Story Viewer

igview-owner/tiktok-story-viewer

View and download TikTok stories from any public profile in seconds. This TikTok Story Viewer actor extracts full story data including video URLs (with and without watermark), cover images, music metadata, engagement metrics (views, likes, comments, shares, saves) and author profile information.

User avatar

Sachin Kumar Yadav

84

TikTok Video Downloader avatar

TikTok Video Downloader

truefetch/tiktok-video-downloader

Download any TikTok video in HD with no watermark, original audio, and creator details — title, hashtags, play count, and like count. $0.05 metadata or $0.25 download.

User avatar

TrueFetch

105

5.0

Pinecone Integration avatar

Pinecone Integration

apify/pinecone-integration

This integration transfers data from Apify Actors to a Pinecone and is a good starting point for a question-answering, search, or RAG use case.

User avatar

Apify

550

3.2

Tiktok video downloader avatar

Tiktok video downloader

pocesar/download-tiktok-video

Download TikTok videos in bulk and save to Apify Key value store

User avatar

Paulo Cesar

521

2.8

Related articles

Blog article image
How to scrape TikTok data
Read more