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 📝

Field	Type	Description
keywords	Array	List of keywords to search for live streams
maxItems	Integer	Maximum 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]