TikTok LIVE Scraper avatar

TikTok LIVE Scraper

Try for free

2 hours trial then $19.99/month - No credit card required now

View all Actors
TikTok LIVE Scraper

TikTok LIVE Scraper

easyapi/tiktok-live-scraper
Try for free

2 hours trial then $19.99/month - No credit card required now

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. 🎥

TikTok Live Search Scraper 🎥

Scrape TikTok live streams data based on search keywords. Extract comprehensive information about ongoing live streams including viewer counts, likes, stream URLs, and broadcaster details.

Features ✨

  • 🔍 Search live streams by keywords
  • 📊 Get detailed stream statistics (viewers, likes)
  • 👤 Extract broadcaster information
  • 🔗 Obtain stream URLs in multiple qualities
  • 🎯 Configurable maximum items to scrape
  • 🚀 Fast and efficient scraping
  • 🛡️ Built-in anti-detection mechanisms

Usage 💡

Simply provide:

  1. Search keywords for live streams
  2. Maximum number of items to scrape (optional)

The actor will automatically:

  • Search TikTok for live streams matching your keywords
  • Extract comprehensive data about each stream
  • Save results in structured format

Output 📦

For each live stream, you'll get detailed information including:

  • Stream ID and status
  • Viewer count and like count
  • Stream URLs (multiple quality options)
  • Broadcaster details (nickname, avatar, follower count)
  • Stream start time
  • Cover images

Input Parameters 📝

FieldTypeDescription
keywordsArrayList of keywords to search for live streams
maxItemsIntegerMaximum number of items to scrape (optional)

Input Example

A full explanation of an input example in JSON.

1{
2    "keywords": [
3        "ronaldo"
4    ],
5    "maxItems": 20
6}

Output sample

The results will be wrapped into a dataset which you can always find in the Storage tab. Here's an excerpt from the data you'd get if you apply the input parameters above:

And here is the same data but in JSON. You can choose in which format to download your data: JSON, JSONL, Excel spreadsheet, HTML table, CSV, or XML.

1[
2	{
3		"id": 7431210864149057000,
4		"id_str": "7431210864149056262",
5		"status": 2,
6		"owner_user_id": 6803805279089001000,
7		"user_count": 6,
8		"client_version": 360900,
9		"cover": {
10			"url_list": [
11				"https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d0e44db2e9a3f3470327cfb88a901a84~c5_720x720.webp?lk3s=a5d48078&nonce=14452&refresh_token=fdbd38532f09fec833692bd94b9568f7&x-expires=1730386800&x-signature=V3akHDdKjpEsxek%2FtUNOhyAQEoY%3D&shp=a5d48078&shcp=fdd36af4",
12				"https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d0e44db2e9a3f3470327cfb88a901a84~c5_720x720.jpeg?lk3s=a5d48078&nonce=73839&refresh_token=9c5d50f6156cb16ea0156b6ad012c34c&x-expires=1730386800&x-signature=bg5zH7xer%2F7ApRfdoxqXJYnBuR8%3D&shp=a5d48078&shcp=fdd36af4"
13			],
14			"uri": "720x720/tos-maliva-avt-0068/d0e44db2e9a3f3470327cfb88a901a84"
15		},
16		"stream_url": {
17			"rtmp_pull_url": "https://pull-w5-va01.tiktokcdn-us.com/stage/stream-2998416432169484338_or4.flv?expire=1731424642&sign=dcac127678c80e62b0914a532e47cb9d",
18			"flv_pull_url": {
19				"FULL_HD1": "https://pull-w5-va01.tiktokcdn-us.com/stage/stream-2998416432169484338_uhd.flv?expire=1731424642&sign=a4fc7361aef6acf921d550bfd94248de",
20				"HD1": "https://pull-w5-va01.tiktokcdn-us.com/stage/stream-2998416432169484338_hd.flv?expire=1731424642&sign=c64f09308148cde6eff4d70735658ede",
21				"SD1": "https://pull-w5-va01.tiktokcdn-us.com/stage/stream-2998416432169484338_ld.flv?expire=1731424642&sign=fb728197a7ed8f96b2760293964a248f",
22				"SD2": "https://pull-w5-va01.tiktokcdn-us.com/stage/stream-2998416432169484338_sd.flv?expire=1731424642&sign=54943e606cc12df524572b9597c7a47f"
23			},
24			"candidate_resolution": [
25				"SD1",
26				"SD2",
27				"HD1",
28				"FULL_HD1"
29			],
30			"flv_pull_url_params": {
31				"FULL_HD1": "{\"VCodec\":\"h264\"}",
32				"HD1": "{\"VCodec\":\"h264\"}",
33				"SD1": "{\"VCodec\":\"h264\"}",
34				"SD2": "{\"VCodec\":\"h264\"}"
35			},
36			"live_core_sdk_data": {
37				"pull_data": {
38					"stream_data": "{\"common\":{\"session_id\":\"052-20241029151721CAB4FC610076060BD8D4\",\"rule_ids\":\"{\\\"ab_version_trace\\\":null,\\\"sched\\\":\\\"{\\\\\\\"ids\\\\\\\":[\\\\\\\"ex_39349(Weight:100)\\\\\\\"],\\\\\\\"result\\\\\\\":{\\\\\\\"hit\\\\\\\":\\\\\\\"exclusive\\\\\\\",\\\\\\\"cdn\\\\\\\":1889}}\\\"}\",\"peer_anchor_level\":2},\"data\":{\"uhd\":{\"main\":{\"flv\":\"https://pull-w5-va01.tiktokcdn-us.com/stage/stream-2998416432169484338_uhd.flv?expire=1731424642\\u0026sign=a4fc7361aef6acf921d550bfd94248de\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"sdk_params\":\"{\\\"vbitrate\\\":1000000,\\\"VCodec\\\":\\\"h264\\\",\\\"resolution\\\":\\\"720x1280\\\",\\\"gop\\\":0,\\\"stream_suffix\\\":\\\"uhd\\\"}\"}},\"ao\":{\"main\":{\"flv\":\"https://pull-w5-va01.tiktokcdn-us.com/stage/stream-2998416432169484338.flv?expire=1731424642\\u0026sign=2c697db6161527420ec51998551ffe43\\u0026only_audio=1\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"vbitrate\\\":0,\\\"resolution\\\":\\\"\\\",\\\"gop\\\":4}\"}},\"origin\":{\"main\":{\"flv\":\"https://pull-w5-va01.tiktokcdn-us.com/stage/stream-2998416432169484338_or4.flv?expire=1731424642\\u0026sign=dcac127678c80e62b0914a532e47cb9d\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"sdk_params\":\"{\\\"gop\\\":4,\\\"stream_suffix\\\":\\\"or4\\\",\\\"VCodec\\\":\\\"h264\\\",\\\"vbitrate\\\":1000000,\\\"resolution\\\":\\\"720x1280\\\"}\"}},\"sd\":{\"main\":{\"flv\":\"https://pull-w5-va01.tiktokcdn-us.com/stage/stream-2998416432169484338_sd.flv?expire=1731424642\\u0026sign=54943e606cc12df524572b9597c7a47f\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"sdk_params\":\"{\\\"vbitrate\\\":800000,\\\"resolution\\\":\\\"480x853\\\",\\\"gop\\\":0,\\\"stream_suffix\\\":\\\"sd\\\",\\\"VCodec\\\":\\\"h264\\\"}\"}},\"ld\":{\"main\":{\"flv\":\"https://pull-w5-va01.tiktokcdn-us.com/stage/stream-2998416432169484338_ld.flv?expire=1731424642\\u0026sign=fb728197a7ed8f96b2760293964a248f\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"sdk_params\":\"{\\\"v_rtbitrate_timestamp\\\":1730215026129,\\\"stream_suffix\\\":\\\"ld\\\",\\\"VCodec\\\":\\\"h264\\\",\\\"vbitrate\\\":500000,\\\"resolution\\\":\\\"480x853\\\",\\\"gop\\\":0,\\\"v_rtbitrate\\\":549625.7930000001,\\\"v_rtpsnr\\\":0}\"}},\"hd\":{\"main\":{\"flv\":\"https://pull-w5-va01.tiktokcdn-us.com/stage/stream-2998416432169484338_hd.flv?expire=1731424642\\u0026sign=c64f09308148cde6eff4d70735658ede\",\"hls\":\"\",\"cmaf\":\"\",\"dash\":\"\",\"lls\":\"\",\"tsl\":\"\",\"tile\":\"\",\"sdk_params\":\"{\\\"VCodec\\\":\\\"h264\\\",\\\"resolution\\\":\\\"540x960\\\",\\\"gop\\\":0,\\\"stream_suffix\\\":\\\"hd\\\",\\\"vbitrate\\\":1000000}\"}}}}",
39					"options": {
40						"default_quality": {
41							"name": "Original",
42							"sdk_key": "origin"
43						}
44					}
45				}
46			}
47		},
48		"stats": {
49			"total_user": 312
50		},
51		"owner": {
52			"id": 6803805279089001000,
53			"nickname": "NALDI",
54			"avatar_thumb": {
55				"url_list": [
56					"https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d0e44db2e9a3f3470327cfb88a901a84~c5_100x100.webp?lk3s=a5d48078&nonce=55267&refresh_token=daa83aeb5c774ccd769906f8acc4c2be&x-expires=1730386800&x-signature=GDK9uLJ3aLGqRaCmo595JEUOU4g%3D&shp=a5d48078&shcp=fdd36af4",
57					"https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d0e44db2e9a3f3470327cfb88a901a84~c5_100x100.jpeg?lk3s=a5d48078&nonce=10730&refresh_token=585388295813b4d64691d3649a6485a2&x-expires=1730386800&x-signature=LdCsIsqUPU0w8oGitbO8T0QP0xk%3D&shp=a5d48078&shcp=fdd36af4"
58				],
59				"uri": "100x100/tos-maliva-avt-0068/d0e44db2e9a3f3470327cfb88a901a84"
60			},
61			"avatar_medium": {
62				"url_list": [
63					"https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d0e44db2e9a3f3470327cfb88a901a84~c5_720x720.webp?lk3s=a5d48078&nonce=14452&refresh_token=fdbd38532f09fec833692bd94b9568f7&x-expires=1730386800&x-signature=V3akHDdKjpEsxek%2FtUNOhyAQEoY%3D&shp=a5d48078&shcp=fdd36af4",
64					"https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d0e44db2e9a3f3470327cfb88a901a84~c5_720x720.jpeg?lk3s=a5d48078&nonce=73839&refresh_token=9c5d50f6156cb16ea0156b6ad012c34c&x-expires=1730386800&x-signature=bg5zH7xer%2F7ApRfdoxqXJYnBuR8%3D&shp=a5d48078&shcp=fdd36af4"
65				],
66				"uri": "720x720/tos-maliva-avt-0068/d0e44db2e9a3f3470327cfb88a901a84"
67			},
68			"avatar_large": {
69				"url_list": [
70					"https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d0e44db2e9a3f3470327cfb88a901a84~c5_1080x1080.webp?lk3s=a5d48078&nonce=18039&refresh_token=bd8f1bfe5fadd04872034fed26ef53ae&x-expires=1730386800&x-signature=T%2FkW9namH4OaniIqExT%2Bws7pWwk%3D&shp=a5d48078&shcp=fdd36af4",
71					"https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/d0e44db2e9a3f3470327cfb88a901a84~c5_1080x1080.jpeg?lk3s=a5d48078&nonce=65230&refresh_token=ddc0cf7d649c0e0a85e92b595bcfb657&x-expires=1730386800&x-signature=UHhw7oqXigrjddQqEvLR1E9atDw%3D&shp=a5d48078&shcp=fdd36af4"
72				],
73				"uri": "1080x1080/tos-maliva-avt-0068/d0e44db2e9a3f3470327cfb88a901a84"
74			},
75			"status": 1,
76			"modify_time": 1729661258,
77			"follow_info": {
78				"following_count": 36,
79				"follower_count": 4222
80			},
81			"pay_grade": {},
82			"user_attr": {},
83			"own_room": {
84				"room_ids": [
85					7431210864149057000
86				],
87				"room_ids_str": [
88					"7431210864149056262"
89				]
90			},
91			"display_id": "ronaldo_1998_",
92			"sec_uid": "MS4wLjABAAAAs9051R7zCunFsWfYhbkYTc1cz4p2RMDv2L8ioPTzEH8qrdvhpwMsvt1O9c8Mr2Ml",
93			"mint_type_label": [
94				7160893592603462000
95			],
96			"id_str": "6803805279089001478"
97		},
98		"start_time": 1730213627,
99		"like_count": 619,
100		"stream_url_filtered_info": {},
101		"cover_type": 1,
102		"sub_tag": 1
103	},
104    ...
105]
Developer
Maintained by Community
Actor metrics
  • 1 monthly user
  • 0 stars
  • 100.0% runs succeeded
  • Created in Oct 2024
  • Modified 1 day ago