TikTok LIVE Scraper avatar

TikTok LIVE Scraper

Pricing

from $4.99 / 1,000 results

Go to Apify Store
TikTok LIVE Scraper

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. πŸŽ₯

Pricing

from $4.99 / 1,000 results

Rating

4.4

(5)

Developer

EasyApi

EasyApi

Maintained by Community

Actor stats

4

Bookmarked

652

Total users

29

Monthly active users

5.1 days

Issues response

4 days ago

Last modified

Categories

Share

TikTok Live Search Scraper πŸŽ₯

Scrape TikTok live streams by search keywords or live categories. Extract comprehensive information about ongoing live streams including viewer counts, likes, stream URLs, and broadcaster details.

Features ✨

  • πŸ” Search live streams by keywords
  • πŸ“‚ Scrape all live streams from a category page (e.g. tiktok.com/live/category/lifestyle)
  • πŸ“Š 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 πŸ’‘

Provide either:

  1. Search keywords for live streams, or
  2. Live category slugs / full category URLs
    Plus optionally:
  3. Maximum number of items to scrape

The actor will automatically:

  • Search TikTok for live streams matching your keywords, or open each category page and collect listed lives
  • Extract comprehensive data about each stream
  • Save results in structured format

Mode rules:

  • If keywords is non-empty β†’ keyword search mode (categories are ignored)
  • Else if categories is non-empty β†’ category mode
  • Provide at least one of keywords or categories

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
  • Source tag: keyword (keyword mode) or category (category mode)

Input Parameters πŸ“

FieldTypeDescription
keywordsArrayList of keywords to search for live streams. Takes priority if both keywords and categories are set.
categoriesArrayLive category slugs or full URLs, e.g. lifestyle or https://www.tiktok.com/live/category/lifestyle. Used when keywords is empty.
maxItemsIntegerMaximum number of items to scrape per keyword or category (optional)

Input Example

Keyword search:

{
"keywords": [
"ronaldo"
],
"maxItems": 20
}

Category scrape:

{
"categories": [
"lifestyle",
"https://www.tiktok.com/live/category/gaming"
],
"maxItems": 30
}

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.

[
{
"id": 7431210864149057000,
"id_str": "7431210864149056262",
"status": 2,
"owner_user_id": 6803805279089001000,
"user_count": 6,
"client_version": 360900,
"cover": {
"url_list": [
"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",
"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"
],
"uri": "720x720/tos-maliva-avt-0068/d0e44db2e9a3f3470327cfb88a901a84"
},
"stream_url": {
"rtmp_pull_url": "https://pull-w5-va01.tiktokcdn-us.com/stage/stream-2998416432169484338_or4.flv?expire=1731424642&sign=dcac127678c80e62b0914a532e47cb9d",
"flv_pull_url": {
"FULL_HD1": "https://pull-w5-va01.tiktokcdn-us.com/stage/stream-2998416432169484338_uhd.flv?expire=1731424642&sign=a4fc7361aef6acf921d550bfd94248de",
"HD1": "https://pull-w5-va01.tiktokcdn-us.com/stage/stream-2998416432169484338_hd.flv?expire=1731424642&sign=c64f09308148cde6eff4d70735658ede",
"SD1": "https://pull-w5-va01.tiktokcdn-us.com/stage/stream-2998416432169484338_ld.flv?expire=1731424642&sign=fb728197a7ed8f96b2760293964a248f",
"SD2": "https://pull-w5-va01.tiktokcdn-us.com/stage/stream-2998416432169484338_sd.flv?expire=1731424642&sign=54943e606cc12df524572b9597c7a47f"
},
"candidate_resolution": [
"SD1",
"SD2",
"HD1",
"FULL_HD1"
],
"flv_pull_url_params": {
"FULL_HD1": "{\"VCodec\":\"h264\"}",
"HD1": "{\"VCodec\":\"h264\"}",
"SD1": "{\"VCodec\":\"h264\"}",
"SD2": "{\"VCodec\":\"h264\"}"
},
"live_core_sdk_data": {
"pull_data": {
"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}\"}}}}",
"options": {
"default_quality": {
"name": "Original",
"sdk_key": "origin"
}
}
}
}
},
"stats": {
"total_user": 312
},
"owner": {
"id": 6803805279089001000,
"nickname": "NALDI",
"avatar_thumb": {
"url_list": [
"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",
"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"
],
"uri": "100x100/tos-maliva-avt-0068/d0e44db2e9a3f3470327cfb88a901a84"
},
"avatar_medium": {
"url_list": [
"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",
"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"
],
"uri": "720x720/tos-maliva-avt-0068/d0e44db2e9a3f3470327cfb88a901a84"
},
"avatar_large": {
"url_list": [
"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",
"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"
],
"uri": "1080x1080/tos-maliva-avt-0068/d0e44db2e9a3f3470327cfb88a901a84"
},
"status": 1,
"modify_time": 1729661258,
"follow_info": {
"following_count": 36,
"follower_count": 4222
},
"pay_grade": {},
"user_attr": {},
"own_room": {
"room_ids": [
7431210864149057000
],
"room_ids_str": [
"7431210864149056262"
]
},
"display_id": "ronaldo_1998_",
"sec_uid": "MS4wLjABAAAAs9051R7zCunFsWfYhbkYTc1cz4p2RMDv2L8ioPTzEH8qrdvhpwMsvt1O9c8Mr2Ml",
"mint_type_label": [
7160893592603462000
],
"id_str": "6803805279089001478"
},
"start_time": 1730213627,
"like_count": 619,
"stream_url_filtered_info": {},
"cover_type": 1,
"sub_tag": 1
},
...
]