What is TikTok Livestream Scraper and how does it work?

TikTok Livestream Scraper is a web scraping tool that enables you to extract detailed livestream data from TikTok using streamers' usernames.

Simply add one or more TikTok usernames in the input field and select the type of data you want to scrape. Then download the data from the output schema.

Why scrape TikTok Livestream?

Scraping TikTok Livestream can help you to:

➡️ Monitor Performance: Keep track of livestream performance metrics to understand how your content is performing.

➡️ Discover Trends: Identify up-and-coming livestreamers and use them as benchmarks for your own performance based on views, conversions, and reviews.

➡️ Improve Engagement: Fine-tune your advertising and messaging strategies by analyzing chat, gifts, battles, likes, emotes, questions, members, envelopes, subscriptions, and sharing data.

➡️ Data-Driven Decisions: Use extensive data to make informed decisions to maximize your TikTok livestream potential.

What can you scrape with TikTok Livestream Scraper?

TikTok Livestream Scraper extracts a wide range of data, including:

• Chat messages
• Gifts
• Battles
• Likes
• Emotes
• Questions
• Members
• Envelopes
• Subscriptions
• Sharing interactions

How much will scraping TikTok Livestream cost you?

Estimating the resources needed to extract data can be challenging as use cases may vary significantly. The best course of action is to run a test scrape with a small sample of input data and limited output. But generally it costs around 0.1$ to scrape 10 livestreams for 1 hour. Of course everything depends on the activity of the livestream and what data you want.

Is it legal to scrape TikTok?

It is legal to scrape publicly available data. Read Apify's blog post on the legality of web scraping to learn more.

Input options

When running TikTok Livestream Scraper, you need to configure what you want to scrape and how it should be extracted. This input is provided either as a JSON file or in the editor on the Apify platform. Most input fields have reasonable default values.

Sample output from TikTok Livestream Scraper (gift)

1{
2	"eventType": "gift",
3	"streamerUsername": "lifestylewithMatyas",
4	"roomId": "73907481235123078918",
5	"timestamp": 1720795484371,
6	"datetime": "2024-07-12 14:44:45",
7	"giftId": 5655,
8	"repeatCount": 1,
9	"groupId": "1710791484088",
10	"userId": "1921231235050176518",
11	"secUid": "<private>",
12	"uniqueId": "botondotvos",
13	"nickname": "Botond Otvos",
14	"profilePictureUrl": "https://example.com",
15	"followRole": 0,
16	"userBadges": [
17		{
18			"type": "image",
19			"badgeSceneType": 6,
20			"displayType": 1,
21			"url": "https://example.com"
22		},
23		{
24			"type": "privilege",
25			"privilegeId": "7196129020441513157",
26			"level": 1,
27			"badgeSceneType": 10
28		}
29	],
30	"userSceneTypes": [
31		6,
32		10,
33		6
34	],
35	"userDetails": {
36		"createTime": "0",
37		"bioDescription": "",
38		"profilePictureUrls": [
39			"https://example.com=",
40			"https://example.com="
41		]
42	},
43	"followInfo": {
44		"followingCount": 1232,
45		"followerCount": 1233,
46		"followStatus": 0,
47		"pushStatus": 0
48	},
49	"isModerator": false,
50	"isNewGifter": false,
51	"isSubscriber": false,
52	"topGifterRank": null,
53	"gifterLevel": 0,
54	"teamMemberLevel": 1,
55	"msgId": "1390759403121014057",
56	"createTime": "1720795484371",
57	"displayType": "webcast_aweme_gift_send_message",
58	"label": "{0:user} sent {1:gift} {2:string}",
59	"repeatEnd": false,
60	"gift": {
61		"gift_id": 5655,
62		"repeat_count": 1,
63		"repeat_end": 0,
64		"gift_type": 1
65	},
66	"describe": "Sent Rose",
67	"giftType": 1,
68	"diamondCount": 1,
69	"giftName": "Rose",
70	"giftPictureUrl": "https://example.com",
71	"receiverUserId": "1921231235050176518"
72}

Integrations and TikTok Livestream Scraper

TikTok Livestream Scraper can be connected with almost any cloud service or web app thanks to integrations on the Apify platform. You can integrate with Make, Zapier, Slack, Airbyte, GitHub, Google Sheets, Google Drive, and more. Or you can use webhooks to carry out an action whenever an event occurs, e.g., get a notification whenever TikTok Livestream Scraper successfully finishes a run.

Using TikTok Livestream Scraper with the Apify API

The Apify API gives you programmatic access to the Apify platform. The API is organized around RESTful HTTP endpoints that enable you to manage, schedule, and run Apify actors. The API also lets you access any datasets, monitor actor performance, fetch results, create and update versions, and more.

To access the API using Node.js, use the apify-client NPM package. To access the API using Python, use the apify-client PyPI package.

Check out the Apify API reference docs for full details.

Your feedback

I am always working on improving the performance of my Actors. So if you’ve got any technical feedback or found a bug, please create an issue on the Actor’s Issues tab in Apify Console.

Events JSON

Note: data here in these examples have been anonymized

Chats

When someone writes something in livestream chat.

1{
2  "eventType": "chat",
3  "streamerUsername": "lifestylewithMatyas",
4  "roomId": 0,
5  "timestamp": 1720805060360,
6  "datetime": "2024-07-12 17:24:20",
7  "emotes": [],
8  "comment": "lest go",
9  "userId": "1921231235050176518",
10  "secUid": "<private>",
11  "uniqueId": "shukrunight",
12  "nickname": "NIASEE",
13  "profilePictureUrl": "https://example.com",
14  "followRole": 2,
15  "userBadges": [
16    {
17      "type": "image",
18      "badgeSceneType": 4,
19      "displayType": 1,
20      "url": "https://example.com"
21    },
22    {
23      "type": "privilege",
24      "privilegeId": "7138381861675357988",
25      "level": 22,
26      "badgeSceneType": 8
27    },
28    {
29      "type": "privilege",
30      "privilegeId": "7196929090442545925",
31      "level": 26,
32      "badgeSceneType": 10
33    }
34  ],
35  "userSceneTypes": [
36    4,
37    8,
38    10,
39    4
40  ],
41  "userDetails": {
42    "createTime": "0",
43    "bioDescription": "",
44    "profilePictureUrls": [
45      "https://example.com",
46      "https://example.com",
47      "https://example.com"
48    ]
49  },
50  "followInfo": {
51    "followingCount": 449,
52    "followerCount": 855,
53    "followStatus": 2,
54    "pushStatus": 0
55  },
56  "isModerator": false,
57  "isNewGifter": false,
58  "isSubscriber": true,
59  "topGifterRank": null,
60  "gifterLevel": 22,
61  "teamMemberLevel": 26,
62  "msgId": "7390801020955020039",
63  "createTime": "1720804970485"
64}

Gifts

When someone sends some gift. For example rose

1{
2  "eventType": "gift",
3  "streamerUsername": "lifestylewithMatyas",
4  "roomId": "7390779679362370309",
5  "timestamp": 1720805097312,
6  "datetime": "2024-07-12 17:24:58",
7  "giftId": 9340,
8  "repeatCount": 1,
9  "groupId": "1720805096480",
10  "userId": "1921231235050176518",
11  "secUid": "<private>",
12  "uniqueId": "matyas",
13  "nickname": "Sắp U30 rồi nha...",
14  "profilePictureUrl": "https://example.com",
15  "followRole": 3,
16  "userBadges": [
17    {
18      "type": "privilege",
19      "privilegeId": "7138381176787441444",
20      "level": 1,
21      "badgeSceneType": 8
22    }
23  ],
24  "userSceneTypes": [
25    8
26  ],
27  "userDetails": {
28    "createTime": "0",
29    "bioDescription": "",
30    "profilePictureUrls": [
31      "https://example.com",
32      "https://example.com",
33      "https://example.com"
34    ]
35  },
36  "followInfo": {
37    "followingCount": 55,
38    "followerCount": 6,
39    "followStatus": 3,
40    "pushStatus": 0
41  },
42  "isModerator": false,
43  "isNewGifter": false,
44  "isSubscriber": false,
45  "topGifterRank": null,
46  "gifterLevel": 1,
47  "teamMemberLevel": 0,
48  "msgId": "7390801201287678727",
49  "createTime": "1720805097312",
50  "displayType": "webcast_aweme_gift_send_message",
51  "label": "{0:user} sent {1:gift} {2:string}",
52  "repeatEnd": false,
53  "gift": {
54    "gift_id": 9340,
55    "repeat_count": 1,
56    "repeat_end": 0,
57    "gift_type": 1
58  },
59  "describe": "Sent Birthday Cake",
60  "giftType": 1,
61  "diamondCount": 1,
62  "giftName": "Birthday Cake",
63  "giftPictureUrl": "https://example.com",
64  "receiverUserId": "1921231235050176518"
65}

New user

When new user joins livestream

1{
2  "eventType": "member",
3  "streamerUsername": "lifestylewithMatyas",
4  "roomId": "7390779679362370309",
5  "timestamp": 1720805098166,
6  "datetime": "2024-07-12 17:24:58",
7  "actionId": 1,
8  "userId": "1921231235050176518",
9  "secUid": "<private>",
10  "uniqueId": "matyas",
11  "nickname": "Trân đy👸",
12  "profilePictureUrl": "https://example.com",
13  "followRole": 1,
14  "userBadges": [],
15  "userSceneTypes": [],
16  "userDetails": {
17    "createTime": "0",
18    "bioDescription": "",
19    "profilePictureUrls": [
20      "https://example.com",
21      "https://example.com",
22      "https://example.com",
23      "https://example.com"
24    ]
25  },
26  "followInfo": {
27    "followingCount": 1255,
28    "followerCount": 297,
29    "followStatus": 1,
30    "pushStatus": 0
31  },
32  "isModerator": false,
33  "isNewGifter": false,
34  "isSubscriber": false,
35  "topGifterRank": null,
36  "gifterLevel": 0,
37  "teamMemberLevel": 0,
38  "createTime": "1720805096619",
39  "msgId": "7390801605367319303",
40  "label": "{0:user} joined",
41  "displayType": "live_room_enter_toast"
42}

Follow

When some user follows livestreameer

1{
2  "eventType": "follow",
3  "streamerUsername": "lifestylewithMatyas",
4  "roomId": "7390779679362370309",
5  "timestamp": 1720805178665,
6  "datetime": "2024-07-12 17:26:18",
7  "userId": "1921231235050176518",
8  "secUid": "<private>",
9  "uniqueId": "matyas",
10  "nickname": "Matyas",
11  "profilePictureUrl": "https://example.com",
12  "followRole": 1,
13  "userBadges": [],
14  "userSceneTypes": [],
15  "userDetails": {
16    "createTime": "0",
17    "bioDescription": "",
18    "profilePictureUrls": [
19      "https://example.com",
20      "https://example.com",
21      "https://example.com",
22      "https://example.com"
23    ]
24  },
25  "followInfo": {
26    "followingCount": 529,
27    "followerCount": 2,
28    "followStatus": 1,
29    "pushStatus": 0
30  },
31  "isModerator": false,
32  "isNewGifter": false,
33  "isSubscriber": false,
34  "topGifterRank": null,
35  "gifterLevel": 0,
36  "teamMemberLevel": 0,
37  "createTime": "1720805177641",
38  "msgId": "7390801954451081985",
39  "displayType": "pm_main_follow_message_viewer_2",
40  "label": "{0:user} followed the LIVE creator"
41}

Shares

When some user shares the livestream somewhere else like instragram

1{
2  "eventType": "share",
3  "streamerUsername": "lifestylewithMatyas",
4  "roomId": "7390781986412989217",
5  "timestamp": 1720805283598,
6  "datetime": "2024-07-12 17:28:03",
7  "userId": "1921231235050176518",
8  "secUid": "<private>",
9  "uniqueId": "anonymized",
10  "nickname": "Marek",
11  "profilePictureUrl": "https://example.com",
12  "followRole": 1,
13  "userBadges": [
14    {
15      "type": "privilege",
16      "privilegeId": "7138381176787556132",
17      "level": 8,
18      "badgeSceneType": 8
19    }
20  ],
21  "userSceneTypes": [
22    8
23  ],
24  "userDetails": {
25    "createTime": "0",
26    "bioDescription": "",
27    "profilePictureUrls": [
28      "https://example.com",
29      "https://example.com",
30      "https://example.com"
31    ]
32  },
33  "followInfo": {
34    "followingCount": 754,
35    "followerCount": 275,
36    "followStatus": 1,
37    "pushStatus": 0
38  },
39  "isModerator": false,
40  "isNewGifter": false,
41  "isSubscriber": false,
42  "topGifterRank": null,
43  "gifterLevel": 8,
44  "teamMemberLevel": 0,
45  "msgId": "7390802402112375584",
46  "createTime": "1720805282468",
47  "displayType": "pm_mt_guidance_share",
48  "label": "{0:user} shared the LIVE"
49}

Like

When someone likes livestream

1{
2  "eventType": "like",
3  "streamerUsername": "lifestylewithMatyas",
4  "roomId": "7390790802081876741",
5  "timestamp": 1720805285405,
6  "datetime": "2024-07-12 17:28:05",
7  "likeCount": 15,
8  "totalLikeCount": 25494,
9  "userId": "1921231235050176518",
10  "secUid": "<private>",
11  "uniqueId": "matyas123",
12  "nickname": "John",
13  "profilePictureUrl": "https://example.com",
14  "followRole": 0,
15  "userBadges": [],
16  "userSceneTypes": [],
17  "userDetails": {
18    "createTime": "0",
19    "bioDescription": "",
20    "profilePictureUrls": [
21      "https://example.com",
22      "https://example.com",
23      "https://example.com"
24    ]
25  },
26  "followInfo": {
27    "followingCount": 69,
28    "followerCount": 218,
29    "followStatus": 0,
30    "pushStatus": 0
31  },
32  "isModerator": false,
33  "isNewGifter": false,
34  "isSubscriber": false,
35  "topGifterRank": null,
36  "gifterLevel": 0,
37  "teamMemberLevel": 0,
38  "msgId": "7390802418889688069",
39  "createTime": "1720805284534",
40  "displayType": "pm_mt_msg_viewer",
41  "label": "{0:user} liked the LIVE"
42}

Subscription

When someone subscribes to livestreamers subscruption

1{
2  "eventType": "subscription",
3  "streamerUsername": "lifestylewithMatyas",
4  "roomId": "7390790802081876741",
5  "timestamp": 1720805285405,
6  "datetime": "2024-07-12 17:28:05",
7    "subMonth": 1,
8    "oldSubscribeStatus": 2,
9    "subscribingStatus": 1,
10    "userId": "1921231235050176518",
11    "secUid": "<private>",
12    "uniqueId": "matyas",
13    "nickname": "MATYAS",
14    "profilePictureUrl": "https://example.com",
15    "followRole": 0,
16    "userBadges": [],
17    "userDetails": {
18        "createTime": "0",
19        "bioDescription": "",
20        "profilePictureUrls": [
21            "https://example.com",
22            "https://example.com"
23        ]
24    },
25    "followInfo": {
26        "followingCount": 23,
27        "followerCount": 43,
28        "followStatus": 0,
29        "pushStatus": 0
30    },
31    "isModerator": false,
32    "isNewGifter": false,
33    "isSubscriber": false,
34    "topGifterRank": null,
35    "msgId": "7137745705032043266",
36    "createTime": "1661885986187",
37    "displayType": "pm_mt_subinfo_user",
38    "label": "{0:user} just subscribed to the host"
39}

Viewer count

"Stats" message TikTok sends everytime something else so check for yourself

1{
2  "eventType": "roomUser",
3  "streamerUsername": "lifestylewithMatyas",
4  "roomId": 0,
5  "timestamp": 1720805060361,
6  "datetime": "2024-07-12 17:24:20",
7  "topViewers": [
8    {
9      "user": {
10        "userId": "1921231235050176518",
11        "secUid": "<private>",
12        "uniqueId": "anonymiz123ed",
13        "nickname": "Anonym",
14        "profilePictureUrl": "https://example.com",
15        "userBadges": [],
16        "userSceneTypes": [],
17        "userDetails": {
18          "createTime": "0",
19          "bioDescription": "",
20          "profilePictureUrls": [
21            "https://example.com",
22            "https://example.com"
23          ]
24        },
25        "isModerator": false,
26        "isNewGifter": false,
27        "isSubscriber": false,
28        "topGifterRank": null,
29        "gifterLevel": 0,
30        "teamMemberLevel": 0
31      },
32      "coinCount": 1
33    },
34    {
35      "user": {
36        "userId": "1921231235050176518",
37        "secUid": "<private>",
38        "uniqueId": "matyas",
39        "nickname": "Dy+ěšzz",
40        "profilePictureUrl": "https://example.com",
41        "userBadges": [],
42        "userSceneTypes": [],
43        "userDetails": {
44          "createTime": "0",
45          "bioDescription": "",
46          "profilePictureUrls": [
47            "https://example.com"
48          ]
49        },
50        "isModerator": false,
51        "isNewGifter": false,
52        "isSubscriber": false,
53        "topGifterRank": null,
54        "gifterLevel": 0,
55        "teamMemberLevel": 0
56      },
57      "coinCount": 1
58    },
59    {
60      "user": {
61        "userId": "1921231235050176518",
62        "secUid": "<private>",
63        "uniqueId": "matyas",
64        "nickname": "NuUaR🐯",
65        "profilePictureUrl": "https://example.com",
66        "userBadges": [],
67        "userSceneTypes": [],
68        "userDetails": {
69          "createTime": "0",
70          "bioDescription": "",
71          "profilePictureUrls": [
72            "https://example.com",
73            "https://example.com"
74          ]
75        },
76        "isModerator": false,
77        "isNewGifter": false,
78        "isSubscriber": false,
79        "topGifterRank": null,
80        "gifterLevel": 0,
81        "teamMemberLevel": 0
82      },
83      "coinCount": 1
84    },
85    {
86      "user": {
87        "userId": "1921231235050176518",
88        "secUid": "<private>",
89        "uniqueId": "matyas",
90        "nickname": "zhee",
91        "profilePictureUrl": "https://example.com",
92        "userBadges": [],
93        "userSceneTypes": [],
94        "userDetails": {
95          "createTime": "0",
96          "bioDescription": "",
97          "profilePictureUrls": [
98            "https://example.com",
99            "https://example.com"
100          ]
101        },
102        "isModerator": false,
103        "isNewGifter": false,
104        "isSubscriber": false,
105        "topGifterRank": null,
106        "gifterLevel": 0,
107        "teamMemberLevel": 0
108      },
109      "coinCount": 0
110    },
111    {
112      "user": {
113        "userId": "1921231235050176518",
114        "secUid": "<private>",
115        "uniqueId": "matyas",
116        "nickname": "Zaim Luqman",
117        "profilePictureUrl": "https://example.com",
118        "userBadges": [],
119        "userSceneTypes": [],
120        "userDetails": {
121          "createTime": "0",
122          "bioDescription": "",
123          "profilePictureUrls": [
124            "https://example.com",
125            "https://example.com"
126          ]
127        },
128        "isModerator": false,
129        "isNewGifter": false,
130        "isSubscriber": false,
131        "topGifterRank": null,
132        "gifterLevel": 0,
133        "teamMemberLevel": 0
134      },
135      "coinCount": 0
136    },
137    {
138      "user": {
139        "userId": "1921231235050176518",
140        "secUid": "<private>",
141        "profilePictureUrl": null,
142        "userBadges": [],
143        "userSceneTypes": [],
144        "userDetails": {
145          "createTime": "0",
146          "bioDescription": ""
147        },
148        "isModerator": false,
149        "isNewGifter": false,
150        "isSubscriber": false,
151        "topGifterRank": null,
152        "gifterLevel": 0,
153        "teamMemberLevel": 0
154      },
155      "coinCount": 0
156    }

Emotes

When someone in livestream sends an emote

1{
2	"eventType": "emote",
3  "streamerUsername": "lifestylewithMatyas",
4  "roomId": 0,
5  "timestamp": 1720805060360,
6  "datetime": "2024-07-12 17:24:20",
7    "userId": "1921231235050176518",
8    "secUid": "<private>",
9    "uniqueId": "matyas",
10    "nickname": "JOHN",
11    "profilePictureUrl": "https://example.com",
12    "followRole": 0, // 0 = none; 1 = follower; 2 = friends,
13    "userBadges": [],
14    "userDetails": {
15        "createTime": "0",
16        "bioDescription": "",
17        "profilePictureUrls": [
18            "https://example.com",
19            "https://example.com",
20            "https://example.com"
21        ]
22    },
23    "followInfo": {
24        "followingCount": 14,
25        "followerCount": 6,
26        "followStatus": 1,
27        "pushStatus": 0
28    },
29    "isModerator": false,
30    "isNewGifter": false,
31    "isSubscriber": true,
32    "topGifterRank": null,
33    "emoteId": "7121025198379731714",
34    "emoteImageUrl": "https://example.com"
35}

Envelope

When someone in livestream sends emote

1{
2	"eventType": "envelope",
3  "streamerUsername": "lifestylewithMatyas",
4  "roomId": 0,
5  "timestamp": 1720805060360,
6  "datetime": "2024-07-12 17:24:20",
7    "userId": "1921231235050176518",
8    "secUid": "<private>",
9    "uniqueId": "matyas",
10    "nickname": "John",
11    "profilePictureUrl": "https://example.com",
12    "followRole": 0, // 0 = none; 1 = follower; 2 = friends
13    "userBadges": [],
14    "userDetails": {
15        "createTime": "0",
16        "bioDescription": "",
17        "profilePictureUrls": [
18            "https://example.com",
19            "https://example.com"
20        ]
21    },
22    "followInfo": {
23        "followingCount": 828,
24        "followerCount": 1353,
25        "followStatus": 0,
26        "pushStatus": 0
27    },
28    "isModerator": false,
29    "isNewGifter": false,
30    "isSubscriber": false,
31    "topGifterRank": null,
32    "coins": 20,
33    "canOpen": 20,
34    "timestamp": 1661887422
35}

Question

When someone sends question

1{
2	"eventType": "question",
3  "streamerUsername": "lifestylewithMatyas",
4  "roomId": 0,
5  "timestamp": 1720805060360,
6  "datetime": "2024-07-12 17:24:20",
7    "questionText": "How was your trip to New York?",
8    "userId": "1921231235050176518",
9    "secUid": "<private>",
10    "uniqueId": "matyas",
11    "nickname": "Matyas",
12    "profilePictureUrl": "https://example.com",
13    "followRole": 0, // 0 = none; 1 = follower; 2 = friends
14    "userBadges": [],
15    "userDetails": {
16        "createTime": "0",
17        "bioDescription": "",
18        "profilePictureUrls": [
19            "https://example.com",
20            "https://example.com",
21            "https://example.com"
22        ]
23    },
24    "followInfo": {
25        "followingCount": 982,
26        "followerCount": 175,
27        "followStatus": 0,
28        "pushStatus": 0
29    },
30    "isModerator": false,
31    "isNewGifter": false,
32    "isSubscriber": false,
33    "topGifterRank": null
34}

Intro

Intromessage to livestream. Often something like "Hi welcome to my LIVE!"

1{
2  "eventType": "liveIntro",
3  "streamerUsername": "lifestylewithMatyas",
4  "roomId": 0,
5  "timestamp": 1720806722012,
6  "datetime": "2024-07-12 17:52:02",
7  "id": {
8    "low": -1283077368,
9    "high": 1704064640,
10    "unsigned": true
11  },
12  "description": "This is a descriptiom ",
13  "userId": "1921231235050176518",
14  "secUid": "<private>",
15  "nickname": "matyas",
16  "profilePictureUrl": "https://example.com",
17  "userBadges": [],
18  "userSceneTypes": [],
19  "userDetails": {
20    "createTime": "0",
21    "bioDescription": "",
22    "profilePictureUrls": [
23      "https://example.com",
24      "https://example.com"
25    ]
26  },
27  "isModerator": false,
28  "isNewGifter": false,
29  "isSubscriber": false,
30  "topGifterRank": null,
31  "gifterLevel": 0,
32  "teamMemberLevel": 0
33}

Battle start

• Gift "battle" start. Two livestreamers go against each other and who gets more gifts from users wins. You can see it in app as a bar on top of the livestream
• This event is called when the battle starts

1{
2    "eventType": "linkMicBattle",
3    "streamerUsername": "lifestylewithMatyas",
4    "roomId": 0,
5    "timestamp": 1720805060360,
6    "datetime": "2024-07-12 17:24:20",
7    "battleUsers": [
8        {
9            "userId": "1921231235050176518", // Host
10            "uniqueId": "matyas",
11            "nickname": "GrowyNation",
12            "profilePictureUrl": "https://example.com",
13            "userBadges": [],
14            "userDetails": {
15                "profilePictureUrls": [
16                    "https://example.com",
17                    "https://example.com"
18                ]
19            },
20            "isModerator": false,
21            "isNewGifter": false,
22            "isSubscriber": false,
23            "topGifterRank": null
24        },
25        {
26            "userId": "1921231235050176518", // Guest
27            "uniqueId": "matyas",
28            "nickname": "Mart",
29            "profilePictureUrl": "https://example.com",
30            "userBadges": [],
31            "userDetails": {
32                "profilePictureUrls": [
33                    "https://example.com",
34                    "https://example.com"
35                ]
36            },
37            "isModerator": false,
38            "isNewGifter": false,
39            "isSubscriber": false,
40            "topGifterRank": null
41        }
42    ]
43}

Battle stats

Battle stats this event is send multiple times in "battle" with updates in the battle. Like who is winning, who earned more gifts... and so on

1{
2	"eventType": "linkMicArmies",
3	"streamerUsername": "lifestylewithMatyas",
4	"roomId": "7390748975683078918",
5	"timestamp": 1720795510938,
6	"datetime": "2024-07-12 14:45:10",
7	"battleStatus": 1,
8	"battleArmies": [
9		{
10			"hostUserId": "1921231235050176518",
11			"points": 68,
12			"participants": [
13				{
14					"userId": "1921231235050176518",
15					"secUid": "<private>",
16					"nickname": "matyas",
17					"profilePictureUrl": null,
18					"userBadges": [],
19					"userSceneTypes": [],
20					"userDetails": {
21						"createTime": "0",
22						"bioDescription": ""
23					},
24					"isModerator": false,
25					"isNewGifter": false,
26					"isSubscriber": false,
27					"topGifterRank": null,
28					"gifterLevel": 0,
29					"teamMemberLevel": 0
30				},
31				{
32					"userId": "1921231235050176518",
33					"secUid": "<private>",
34					"nickname": "matyas",
35					"profilePictureUrl": null,
36					"userBadges": [],
37					"userSceneTypes": [],
38					"userDetails": {
39						"createTime": "0",
40						"bioDescription": ""
41					},
42					"isModerator": false,
43					"isNewGifter": false,
44					"isSubscriber": false,
45					"topGifterRank": null,
46					"gifterLevel": 0,
47					"teamMemberLevel": 0
48				},
49				{
50					"userId": "1921231235050176518",
51					"secUid": "<private>",
52					"nickname": "luz potenciano 26",
53					"profilePictureUrl": null,
54					"userBadges": [],
55					"userSceneTypes": [],
56					"userDetails": {
57						"createTime": "0",
58						"bioDescription": ""
59					},
60					"isModerator": false,
61					"isNewGifter": false,
62					"isSubscriber": false,
63					"topGifterRank": null,
64					"gifterLevel": 0,
65					"teamMemberLevel": 0
66				}
67			]
68		},
69		{
70			"hostUserId": "1921231235050176518",
71			"points": 44,
72			"participants": [
73				{
74					"userId": "1921231235050176518",
75					"secUid": "",
76					"nickname": "matyas",
77					"profilePictureUrl": null,
78					"userBadges": [],
79					"userSceneTypes": [],
80					"userDetails": {
81						"createTime": "0",
82						"bioDescription": ""
83					},
84					"isModerator": false,
85					"isNewGifter": false,
86					"isSubscriber": false,
87					"topGifterRank": null,
88					"gifterLevel": 0,
89					"teamMemberLevel": 0
90				},
91				{
92					"userId": "1921231235050176518",
93					"secUid": "<private>",
94					"nickname": "matyas",
95					"profilePictureUrl": null,
96					"userBadges": [],
97					"userSceneTypes": [],
98					"userDetails": {
99						"createTime": "0",
100						"bioDescription": ""
101					},
102					"isModerator": false,
103					"isNewGifter": false,
104					"isSubscriber": false,
105					"topGifterRank": null,
106					"gifterLevel": 0,
107					"teamMemberLevel": 0
108				},
109				{
110					"userId": "1921231235050176518",
111					"secUid": "<private>",
112					"nickname": "matyas",
113					"profilePictureUrl": null,
114					"userBadges": [],
115					"userSceneTypes": [],
116					"userDetails": {
117						"createTime": "0",
118						"bioDescription": ""
119					},
120					"isModerator": false,
121					"isNewGifter": false,
122					"isSubscriber": false,
123					"topGifterRank": null,
124					"gifterLevel": 0,
125					"teamMemberLevel": 0
126				}
127			]
128		}
129	]
130}

If you find any issue or you have some question just open new issue on this scraper I will get back to you as fast as I can.