TikTokLive Python API (Unofficial)
==================
TikTokLive is an unofficial Python API wrapper for TikTok LIVE written in Python. With this library you can connect to any TikTok livestream and fetch all data available to users in a stream using just a creator's `@unique_id`.
[](https://discord.gg/N3KSxzvDX8)
> [!NOTE]
> This is <strong>not</strong> a production-ready API. It is a reverse engineering project. Use the [WebSocket API](https://www.eulerstream.com/websockets) for production.
<a href="https://www.eulerstream.com/websockets" target="_blank">
<img src="https://www.eulerstream.com/api/advert?l2=WebSocket+API&r=15&b=1.5&bc=404854&o=0.95"/>
</a>
<!--
Temporarily Removed May 3rd 2025
## Author's Choice
The following are my two favourite enterprise use-cases for the TikTokLive family of libraries. This is <strong>not</strong> paid promotion, and I receive nothing for these recommendations:
<table>
<tr>
<td><br/><img width="180px" style="border-radius: 10px" src="https://tiktory.com/images/meta/favicon.svg"><br/><br/></td>
<td>
<a href="https://www.tiktory.com">
<strong>Tiktory</strong> provides highly advanced custom overlays, follower alerts, and real-time goal tracking. Seamlessly integrate with OBS and stand out from the crowd!
</a>
</td>
</tr>
</table>
<table>
<tr>
<td><br/><img width="180px" style="border-radius: 10px" src="https://cdn.casterlabs.co/branding/casterlabs/icon.svg"><br/><br/></td>
<td>
<a href="https://casterlabs.co/">
<strong>Casterlabs</strong> is a powerful tool that unifies chats from various streaming platforms, providing a combined chat view, customizable alerts, and handy on-screen widgets for streamers!
</a>
</td>
</tr>
</table>
-->
## Table of Contents
- [Getting Started](#getting-started)
- [Parameters](#parameters)
- [Methods](#methods)
- [Properties](#properties)
- [WebDefaults](#webdefaults)
- [Documentation](https://isaackogan.github.io/TikTokLive/)
- [Other Languages](#other-languages)
- [Community](#community)
- [Examples](https://github.com/isaackogan/TikTokLive/tree/master/examples)
- [Licensing](#license)
- [Star History](#star-history)
- [Contributors](#contributors)
## Community
Join the [TikTokLive discord](https://discord.gg/e2XwPNTBBr) and visit
the [`#py-support`](https://discord.gg/uja6SajDxd)
channel for questions, contributions and ideas.
## Getting Started
1. Install the module via pip from the [PyPi](https://pypi.org/project/TikTokLive/) repository
```shell script
pip install TikTokLive
```
2. Create your first chat connection
```python
from TikTokLive import TikTokLiveClient
from TikTokLive.events import ConnectEvent, CommentEvent
# Create the client
client: TikTokLiveClient = TikTokLiveClient(unique_id="@isaackogz")
# Listen to an event with a decorator!
@client.on(ConnectEvent)
async def on_connect(event: ConnectEvent):
print(f"Connected to @{event.unique_id} (Room ID: {client.room_id}")
# Or, add it manually via "client.add_listener()"
async def on_comment(event: CommentEvent) -> None:
print(f"{event.user.nickname} -> {event.comment}")
client.add_listener(CommentEvent, on_comment)
if __name__ == '__main__':
# Run the client and block the main thread
# await client.start() to run non-blocking
client.run()
```
For more quickstart examples, see the [examples folder](https://github.com/isaackogan/TikTokLive/tree/master/examples)
provided in the source tree.
## Other Languages
TikTokLive is available in several alternate programming languages:
- **Node.JS:** [https://github.com/zerodytrash/TikTok-Live-Connector](https://github.com/zerodytrash/TikTok-Live-Connector)
- **Java:** [https://github.com/jwdeveloper/TikTok-Live-Java](https://github.com/jwdeveloper/TikTok-Live-Java)
- **C#/Unity:** [https://github.com/frankvHoof93/TikTokLiveSharp](https://github.com/frankvHoof93/TikTokLiveSharp)
- **Go:** [https://github.com/steampoweredtaco/gotiktoklive](https://github.com/steampoweredtaco/gotiktoklive)
- **Rust:** [https://github.com/jwdeveloper/TikTokLiveRust](https://github.com/jwdeveloper/TikTokLiveRust)
## Parameters
| Param Name | Required | Default | Description |
|------------|----------|---------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| unique_id | Yes | N/A | The unique username of the broadcaster. You can find this name in the URL of the user. For example, the `unique_id` for [`https://www.tiktok.com/@isaackogz`](https://www.tiktok.com/@isaackogz) would be `isaackogz`. |
| web_proxy | No | `None` | TikTokLive supports proxying HTTP requests. This parameter accepts an `httpx.Proxy`. Note that if you do use a proxy you may be subject to reduced connection limits at times of high load. |
| ws_proxy | No | `None` | TikTokLive supports proxying the websocket connection. This parameter accepts an `httpx.Proxy`. Using this proxy will never be subject to reduced connection limits. |
| web_kwargs | No | `{}` | Under the scenes, the TikTokLive HTTP client uses the [`httpx`](https://github.com/encode/httpx) library. Arguments passed to `web_kwargs` will be forward the the underlying HTTP client. |
| ws_kwargs | No | `{}` | Under the scenes, TikTokLive uses the [`websockets`](https://github.com/python-websockets/websockets) library to connect to TikTok. Arguments passed to `ws_kwargs` will be forwarded to the underlying WebSocket client. |
## Methods
A `TikTokLiveClient` object contains the following methods worth mentioning:
| Method Name | Notes | Description |
|--------------|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| run | N/A | Connect to the livestream and block the main thread. This is best for small scripts. |
| add_listener | N/A | Adds an *asynchronous* listener function (or, you can decorate a function with `@client.on(Type[Event])`) and takes two parameters, an event name and the payload, an AbstractEvent ||
| connect | `async` | Connects to the tiktok live chat while blocking the current future. When the connection ends (e.g. livestream is over), the future is released. |
| start | `async` | Connects to the live chat without blocking the main thread. This returns an `asyncio.Task` object with the client loop. |
| disconnect | `async` | Disconnects the client from the websocket gracefully, processing remaining events before ending the client loop. |
## Properties
A `TikTokLiveClient` object contains the following important properties:
| Attribute Name | Description |
|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
| room_id | The Room ID of the livestream room the client is currently connected to. |
| web | The TikTok HTTP client. This client has a lot of useful routes you should explore! |
| connected | Whether you are currently connected to the livestream. |
| logger | The internal logger used by TikTokLive. You can use `client.logger.setLevel(...)` method to enable client debug. |
| room_info | Room information that is retrieved from TikTok when you use a connection method (e.g. `client.connect`) with the keyword argument `fetch_room_info=True` . |
| gift_info | Extra gift information that is retrieved from TikTok when you use a connection method (e.g. `client.run`) with the keyword argument `fetch_gift_info=True`. |
## WebDefaults
TikTokLive has a series of global defaults used to create the HTTP client which you can customize. For info on how to set these parameters, see
the [web_defaults.py](https://github.com/isaackogan/TikTokLive/blob/master/examples/web_defaults.py) example.
| Parameter | Type | Description |
|-----------------------------|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| tiktok_sign_api_key | `str` | A [Euler Stream](https://www.eulerstream.com/) API key used to increase rate limits. |
| tiktok_app_url | `str` | The TikTok app URL (`https://www.tiktok.com`) used to scrape the room. |
| tiktok_sign_url | `str` | The [signature server](https://www.eulerstream.com/) used to generate tokens to connect to TikTokLive. By default, this is Euler Stream, but you can swap your own with ease. |
| tiktok_webcast_url | `str` | The TikTok livestream URL (`https://webcast.tiktok.com`) where livestreams can be accessed from. |
| web_client_params | `dict` | The URL parameters added on to TikTok requests from the HTTP client. |
| web_client_headers | `dict` | The headers added on to TikTok requests from the HTTP client. |
| web_client_cookies | `dict` | Custom cookies to initialize the http client with. |
| ws_client_params | `dict` | The URL parameters added to the URI when connecting to TikTok's Webcast WebSocket server. |
| ws_client_params_append_str | `dict` | Extra string data to append to the TikTokLive WebSocket connection URI. |
| ws_client_headers | `dict` | Extra headers to append to the TikTokLive WebSocket client. |
| ja3_impersonate | `str` | The ja3 fingerprint to impersonate. This should match whatever the current version is on the Sign Server, or "privileged" methods will fail. |
## Events
Events can be listened to using a decorator or non-decorator method call. The following examples illustrate how you can listen to an event:
```python
@client.on(LikeEvent)
async def on_like(event: LikeEvent) -> None:
...
async def on_comment(event: CommentEvent) -> None:
...
client.add_listener(CommentEvent, on_comment)
```
There are two types of events, [`CustomEvent`](https://github.com/isaackogan/TikTokLive/blob/master/TikTokLive/events/custom_events.py)
events and [`ProtoEvent`](https://github.com/isaackogan/TikTokLive/blob/master/TikTokLive/events/proto_events.py) events.
Both belong to the TikTokLive `Event` type and can be listened to. The following events are available:
### Custom Events
- `ConnectEvent` - Triggered when the Webcast connection is initiated
- `DisconnectEvent` - Triggered when the Webcast connection closes (including the livestream ending)
- `LiveEndEvent` - Triggered when the livestream ends
- `LivePauseEvent` - Triggered when the livestream is paused
- `LiveUnpauseEvent` - Triggered when the livestream is unpaused
- `FollowEvent` - Triggered when a user in the livestream follows the streamer
- `ShareEvent` - Triggered when a user shares the livestream
- `WebsocketResponseEvent` - Triggered when any event is received (contains the event)
- `UnknownEvent` - An instance of `WebsocketResponseEvent` thrown whenever an event does not have an existing definition, useful for debugging
### Proto Events
If you know what an event does, [make a pull request](https://github.com/isaackogan/TikTokLive/pulls) and add the description.
<details>
<summary><h4>Proto Events</h4></summary>
<ul>
<li><code>GiftEvent</code> - Triggered when a gift is sent to the streamer</li>
<li><code>GoalUpdateEvent</code> - Triggered when the subscriber goal is updated</li>
<li><code>ControlEvent</code> - Triggered when a stream action occurs (e.g. Livestream start, end)</li>
<li><code>LikeEvent</code> - Triggered when the stream receives a like</li>
<li><code>SubscribeEvent</code> - Triggered when someone subscribes to the TikTok creator</li>
<li><code>PollEvent</code> - Triggered when the creator launches a new poll</li>
<li><code>CommentEvent</code> - Triggered when a comment is sent in the stream</li>
<li><code>RoomEvent</code> - Messages broadcasted to all users in the room (e.g. "Welcome to TikTok LIVE!")</li>
<li><code>EmoteChatEvent</code> - Triggered when a custom emote is sent in the chat</li>
<li><code>EnvelopeEvent</code> - Triggered every time someone sends a treasure chest</li>
<li><code>SocialEvent</code> - Triggered when a user shares the stream or follows the host</li>
<li><code>QuestionNewEvent</code> - Triggered every time someone asks a new question via the question feature</li>
<li><code>LiveIntroEvent</code> - Triggered when a live intro message appears</li>
<li><code>LinkMicArmiesEvent</code> - Triggered when a TikTok battle user receives points</li>
<li><code>LinkMicBattleEvent</code> - Triggered when a TikTok battle is started</li>
<li><code>JoinEvent</code> - Triggered when a user joins the livestream</li>
<li><code>LinkMicFanTicketMethodEvent</code></li>
<li><code>LinkMicMethodEvent</code></li>
<li><code>BarrageEvent</code> - Triggered when a "VIP" viewer (based on their gifting level) joins the live chat room</li>
<li><code>CaptionEvent</code></li>
<li><code>ImDeleteEvent</code> - Triggered when a viewer's messages are deleted</li>
<li><code>RoomUserSeqEvent</code> - Current viewer count information</li>
<li><code>RankUpdateEvent</code></li>
<li><code>RankTextEvent</code> - Triggered when gift count makes a viewer one of the top three</li>
<li><code>HourlyRankEvent</code></li>
<li><code>UnauthorizedMemberEvent</code></li>
<li><code>MessageDetectEvent</code></li>
<li><code>OecLiveShoppingEvent</code></li>
<li><code>RoomPinEvent</code> - Triggered when a message is pinned</li>
<li><code>SystemEvent</code></li>
<li><code>LinkEvent</code></li>
<li><code>LinkLayerEvent</code></li>
<li><code>KaraokeQueueListEvent</code></li>
<li><code>GroupLiveMemberNotifyEvent</code></li>
<li><code>SubscriptionGuideEvent</code></li>
<li><code>NoticeboardReviewEvent</code></li>
<li><code>BottomEvent</code></li>
<li><code>CapsuleEvent</code></li>
<li><code>LinkMicBattleEvent</code></li>
<li><code>QuestionSelectedEvent</code></li>
<li><code>TrayEvent</code></li>
<li><code>AssetEvent</code></li>
<li><code>WalletLiveRewardsRatioEvent</code></li>
<li><code>LinkScreenChangeEvent</code></li>
<li><code>PartnershipPunishEvent</code></li>
<li><code>GiftPanelUpdateEvent</code></li>
<li><code>AnchorTaskReminderEvent</code></li>
<li><code>LinkBusinessEvent</code></li>
<li><code>MarqueeAnnouncementEvent</code></li>
<li><code>GiftDynamicRestrictionEvent</code></li>
<li><code>CommonPopupEvent</code></li>
<li><code>EcBarrageEvent</code></li>
<li><code>PromoteAdStatusEvent</code></li>
<li><code>InteractionHubGoalEvent</code></li>
<li><code>EpiEvent</code></li>
<li><code>LinkmicAnimationEvent</code></li>
<li><code>KaraokeYouSingReqEvent</code></li>
<li><code>RealTimePerformancePageEvent</code></li>
<li><code>StreamStatusEvent</code></li>
<li><code>GiftCollectionUpdateEvent</code></li>
<li><code>CommercialCustomEvent</code></li>
<li><code>GuideEvent</code></li>
<li><code>DonationEvent</code></li>
<li><code>LiveGameIntroEvent</code></li>
<li><code>PartnershipDropsCardChangeEvent</code></li>
<li><code>GameGuessWidgetsEvent</code></li>
<li><code>MiddleTouchEvent</code></li>
<li><code>UserStatsEvent</code></li>
<li><code>WallpaperReviewEvent</code></li>
<li><code>LinkMicAdEvent</code></li>
<li><code>SubTimerStickerEvent</code></li>
<li><code>GiftGalleryEvent</code></li>
<li><code>GiftUpdateEvent</code></li>
<li><code>NoticeboardEvent</code></li>
<li><code>UpgradeEvent</code></li>
<li><code>BackpackEvent</code></li>
<li><code>AvatarStyleResultEvent</code></li>
<li><code>GameSettingChangeEvent</code></li>
<li><code>PartnershipDropsUpdateEvent</code></li>
<li><code>QuestionSwitchEvent</code></li>
<li><code>LiveInfoAuditNoticeEvent</code></li>
<li><code>CommonToastEvent</code></li>
<li><code>ToastEvent</code></li>
<li><code>DonationStickerModifyMethodEvent</code></li>
<li><code>PollEvent</code></li>
<li><code>HighlightFragementReadyEvent</code></li>
<li><code>GiftPromptEvent</code></li>
<li><code>ForceFetchRecommendationsEvent</code></li>
<li><code>GameGuessPinCardEvent</code></li>
<li><code>LinkLayoutEvent</code></li>
<li><code>GameOcrPingEvent</code></li>
<li><code>AnchorGrowLevelEvent</code></li>
<li><code>EnvelopePortalEvent</code></li>
<li><code>CohostReserveEvent</code></li>
<li><code>BaLeadGenEvent</code></li>
<li><code>PictionaryEndEvent</code></li>
<li><code>RoomNotifyEvent</code></li>
<li><code>FansEventEvent</code></li>
<li><code>KaraokeQueueEvent</code></li>
<li><code>FollowCardEvent</code></li>
<li><code>ActivityQuizUserIdentityEvent</code></li>
<li><code>LiveJourneyEvent</code></li>
<li><code>CommentsEvent</code></li>
<li><code>WeeklyRankRewardEvent</code></li>
<li><code>LinkStateEvent</code></li>
<li><code>AccessRecallEvent</code></li>
<li><code>AiSummaryEvent</code></li>
<li><code>PerceptionEvent</code></li>
<li><code>RoomVerifyEvent</code></li>
<li><code>GuideTaskEvent</code></li>
<li><code>VideoLiveCouponRcmdEvent</code></li>
<li><code>VideoLiveGoodsRcmdEvent</code></li>
<li><code>KaraokeSwitchEvent</code></li>
<li><code>PrivilegeAdvanceEvent</code></li>
<li><code>LinkMicBattlePunishFinishEvent</code></li>
<li><code>BoostedUsersEvent</code></li>
<li><code>RankToastEvent</code></li>
<li><code>CommentTrayEvent</code></li>
<li><code>AnchorReminderWordEvent</code></li>
<li><code>PaidContentLiveShoppingEvent</code></li>
<li><code>RoomEventEvent</code></li>
<li><code>RoomBottomEvent</code></li>
<li><code>DonationInfoEvent</code></li>
<li><code>GameMomentEvent</code></li>
<li><code>HashtagEvent</code></li>
<li><code>LinkMicBattleItemCardEvent</code></li>
<li><code>PrivilegeDynamicEffectEvent</code></li>
<li><code>AnchorGetSubQuotaEvent</code></li>
<li><code>OecLiveHotRoomEvent</code></li>
<li><code>AudienceReserveUserStateEvent</code></li>
<li><code>RealtimeLiveCenterMethodEvent</code></li>
<li><code>WallpaperEvent</code></li>
<li><code>SubPinEventEvent</code></li>
<li><code>LinkmicBattleTaskEvent</code></li>
<li><code>StarCommentPushEvent</code></li>
<li><code>EcTaskRefreshCouponListEvent</code></li>
<li><code>ShortTouchEvent</code></li>
<li><code>EffectControlEvent</code></li>
<li><code>KaraokeRedDotEvent</code></li>
<li><code>QuestionDeleteEvent</code></li>
<li><code>InRoomBannerEvent</code></li>
<li><code>ShareGuideEvent</code></li>
<li><code>EventEvent</code></li>
<li><code>InRoomBannerEventEvent</code></li>
<li><code>PlayTogetherEvent</code></li>
<li><code>SubContractStatusEvent</code></li>
<li><code>HourlyRankRewardEvent</code></li>
<li><code>PictionaryStartEvent</code></li>
<li><code>GuestInviteEvent</code></li>
<li><code>NoticeEvent</code></li>
<li><code>PartnershipDownloadCountEvent</code></li>
<li><code>GreetingEvent</code></li>
<li><code>LiveShowEvent</code></li>
<li><code>SubWaveEvent</code></li>
<li><code>GameReqSetGuessEvent</code></li>
<li><code>SpeakerEvent</code></li>
<li><code>LinkMicAnchorGuideEvent</code></li>
<li><code>CompetitionEvent</code></li>
<li><code>AvatarReportDeleteEvent</code></li>
<li><code>EffectPreloadingEvent</code></li>
<li><code>ColdStartEvent</code></li>
<li><code>CountdownForAllEvent</code></li>
<li><code>GiftBroadcastEvent</code></li>
<li><code>PreviewGameMomentEvent</code></li>
<li><code>GameRecommendCreateGuessEvent</code></li>
<li><code>VideoLiveGoodsOrderEvent</code></li>
<li><code>StarCommentNotificationEvent</code></li>
<li><code>InRoomBannerRefreshEvent</code></li>
<li><code>RoomStickerEvent</code></li>
<li><code>GiftProgressEvent</code></li>
<li><code>OecLiveManagerEvent</code></li>
<li><code>DiggEvent</code></li>
<li><code>AiLiveSummaryEvent</code></li>
<li><code>AnchorToolModificationEvent</code></li>
<li><code>MgPunishCenterActionEvent</code></li>
<li><code>PictionaryExitEvent</code></li>
<li><code>CountdownEvent</code></li>
<li><code>GameServerFeatureEvent</code></li>
<li><code>PlaybookEvent</code></li>
<li><code>GiftRecordCapsuleEvent</code></li>
<li><code>QuickChatListEvent</code></li>
<li><code>PartnershipCardChangeEvent</code></li>
<li><code>ScreenChatEvent</code></li>
<li><code>GameEmoteUpdateEvent</code></li>
<li><code>BoostCardEvent</code></li>
<li><code>RoomStreamAdaptationEvent</code></li>
<li><code>LinkmicBattleNoticeEvent</code></li>
<li><code>GoodyBagEvent</code></li>
</ul>
</details>
### Special Events
### `GiftEvent`
Triggered every time a gift arrives. Extra information can be gleamed from the `available_gifts` client attribute.
> **NOTE:** Users have the capability to send gifts in a streak. This increases the `event.gift.repeat_count` value until the
> user terminates the streak. During this time new gift events are triggered again and again with an
> increased `event.gift.repeat_count` value. It should be noted that after the end of a streak, a final gift event is
> triggered, which signals the end of the streak with `event.repeat_end`:`1`. The following handlers show how you can deal with this in your code.
Using the low-level direct proto:
```python
@client.on(GiftEvent)
async def on_gift(event: GiftEvent):
# If it's type 1 and the streak is over
if event.gift.info.type == 1:
if event.gift.is_repeating == 1:
print(f"{event.user.unique_id} sent {event.repeat_count}x \"{event.gift.name}\"")
# It's not type 1, which means it can't have a streak & is automatically over
elif event.gift.info.type != 1:
print(f"{event.user.unique_id} sent \"{event.gift.name}\"")
```
Using the TikTokLive extended proto:
```python
@client.on("gift")
async def on_gift(event: GiftEvent):
# Streakable gift & streak is over
if event.gift.streakable and not event.streaking:
print(f"{event.user.unique_id} sent {event.repeat_count}x \"{event.gift.name}\"")
# Non-streakable gift
elif not event.gift.streakable:
print(f"{event.user.unique_id} sent \"{event.gift.name}\"")
```
### `SubscribeEvent`
This event will only fire when a session ID (account login) is passed to the HTTP client *before* connecting to TikTok LIVE.
You can set the session ID with [`client.web.set_session_id(...)`](https://github.com/isaackogan/TikTokLive/blob/master/examples/logged_in.py).
## Checking If A User Is Live
It is considered inefficient to use the connect method to check if a user is live. It is better to use the dedicated `await client.is_live()` method.
There is a [complete example](https://github.com/isaackogan/TikTokLive/blob/master/examples/check_live.py) of how to do this in the [examples](https://github.com/isaackogan/TikTokLive/tree/master/examples) folder.
## Star History
<p align="center">
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=isaackogan/TikTokLive&type=Date&theme=dark" onerror="this.src='https://api.star-history.com/svg?repos=isaackogan/TikTokLive&type=Date'" />
</p>
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Contributors
* **Isaac Kogan** - *Creator, Primary Maintainer, and Reverse-Engineering* - [isaackogan](https://github.com/isaackogan)
* **Zerody** - *Creator of the NodeJS library, introduced me to scraping TikTok LIVE* - [Zerody](https://github.com/zerodytrash/)
See also the full list of secondary [contributors](https://github.com/isaackogan/TikTokLive/contributors) who have participated in
this project.
Raw data
{
"_id": null,
"home_page": null,
"name": "TikTokLive",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "tiktok, tiktok live, python3, api, unofficial",
"author": null,
"author_email": "Isaac Kogan <info@isaackogan.com>",
"download_url": "https://files.pythonhosted.org/packages/28/09/295a05e92df26419665b78aad58516e4492ea1c6283bc0f1bfc7c19c46fb/tiktoklive-6.6.5.tar.gz",
"platform": null,
"description": "TikTokLive Python API (Unofficial)\n==================\nTikTokLive is an unofficial Python API wrapper for TikTok LIVE written in Python. With this library you can connect to any TikTok livestream and fetch all data available to users in a stream using just a creator's `@unique_id`.\n\n[](https://discord.gg/N3KSxzvDX8)\n\n\n\n\n\n\n> [!NOTE]\n> This is <strong>not</strong> a production-ready API. It is a reverse engineering project. Use the [WebSocket API](https://www.eulerstream.com/websockets) for production.\n\n<a href=\"https://www.eulerstream.com/websockets\" target=\"_blank\">\n <img src=\"https://www.eulerstream.com/api/advert?l2=WebSocket+API&r=15&b=1.5&bc=404854&o=0.95\"/>\n</a>\n\n<!--\nTemporarily Removed May 3rd 2025\n\n## Author's Choice\n\nThe following are my two favourite enterprise use-cases for the TikTokLive family of libraries. This is <strong>not</strong> paid promotion, and I receive nothing for these recommendations:\n\n<table>\n<tr>\n <td><br/><img width=\"180px\" style=\"border-radius: 10px\" src=\"https://tiktory.com/images/meta/favicon.svg\"><br/><br/></td>\n <td>\n <a href=\"https://www.tiktory.com\">\n <strong>Tiktory</strong> provides highly advanced custom overlays, follower alerts, and real-time goal tracking. Seamlessly integrate with OBS and stand out from the crowd!\n </a>\n </td>\n</tr>\n</table>\n\n<table>\n<tr>\n <td><br/><img width=\"180px\" style=\"border-radius: 10px\" src=\"https://cdn.casterlabs.co/branding/casterlabs/icon.svg\"><br/><br/></td>\n <td>\n <a href=\"https://casterlabs.co/\">\n <strong>Casterlabs</strong> is a powerful tool that unifies chats from various streaming platforms, providing a combined chat view, customizable alerts, and handy on-screen widgets for streamers!\n </a>\n </td>\n</tr>\n</table>\n\n-->\n\n## Table of Contents\n\n- [Getting Started](#getting-started)\n - [Parameters](#parameters)\n - [Methods](#methods)\n - [Properties](#properties)\n - [WebDefaults](#webdefaults)\n- [Documentation](https://isaackogan.github.io/TikTokLive/)\n- [Other Languages](#other-languages)\n- [Community](#community)\n- [Examples](https://github.com/isaackogan/TikTokLive/tree/master/examples)\n- [Licensing](#license)\n- [Star History](#star-history)\n- [Contributors](#contributors)\n\n## Community\n\nJoin the [TikTokLive discord](https://discord.gg/e2XwPNTBBr) and visit\nthe [`#py-support`](https://discord.gg/uja6SajDxd)\nchannel for questions, contributions and ideas.\n\n## Getting Started\n\n1. Install the module via pip from the [PyPi](https://pypi.org/project/TikTokLive/) repository\n\n```shell script\npip install TikTokLive\n```\n\n2. Create your first chat connection\n\n```python\nfrom TikTokLive import TikTokLiveClient\nfrom TikTokLive.events import ConnectEvent, CommentEvent\n\n# Create the client\nclient: TikTokLiveClient = TikTokLiveClient(unique_id=\"@isaackogz\")\n\n\n# Listen to an event with a decorator!\n@client.on(ConnectEvent)\nasync def on_connect(event: ConnectEvent):\n print(f\"Connected to @{event.unique_id} (Room ID: {client.room_id}\")\n\n\n# Or, add it manually via \"client.add_listener()\"\nasync def on_comment(event: CommentEvent) -> None:\n print(f\"{event.user.nickname} -> {event.comment}\")\n\n\nclient.add_listener(CommentEvent, on_comment)\n\nif __name__ == '__main__':\n # Run the client and block the main thread\n # await client.start() to run non-blocking\n client.run()\n```\n\nFor more quickstart examples, see the [examples folder](https://github.com/isaackogan/TikTokLive/tree/master/examples)\nprovided in the source tree.\n\n## Other Languages\n\nTikTokLive is available in several alternate programming languages:\n\n- **Node.JS:** [https://github.com/zerodytrash/TikTok-Live-Connector](https://github.com/zerodytrash/TikTok-Live-Connector)\n- **Java:** [https://github.com/jwdeveloper/TikTok-Live-Java](https://github.com/jwdeveloper/TikTok-Live-Java)\n- **C#/Unity:** [https://github.com/frankvHoof93/TikTokLiveSharp](https://github.com/frankvHoof93/TikTokLiveSharp)\n- **Go:** [https://github.com/steampoweredtaco/gotiktoklive](https://github.com/steampoweredtaco/gotiktoklive)\n- **Rust:** [https://github.com/jwdeveloper/TikTokLiveRust](https://github.com/jwdeveloper/TikTokLiveRust)\n\n## Parameters\n\n| Param Name | Required | Default | Description |\n|------------|----------|---------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| unique_id | Yes | N/A | The unique username of the broadcaster. You can find this name in the URL of the user. For example, the `unique_id` for [`https://www.tiktok.com/@isaackogz`](https://www.tiktok.com/@isaackogz) would be `isaackogz`. |\n| web_proxy | No | `None` | TikTokLive supports proxying HTTP requests. This parameter accepts an `httpx.Proxy`. Note that if you do use a proxy you may be subject to reduced connection limits at times of high load. |\n| ws_proxy | No | `None` | TikTokLive supports proxying the websocket connection. This parameter accepts an `httpx.Proxy`. Using this proxy will never be subject to reduced connection limits. |\n| web_kwargs | No | `{}` | Under the scenes, the TikTokLive HTTP client uses the [`httpx`](https://github.com/encode/httpx) library. Arguments passed to `web_kwargs` will be forward the the underlying HTTP client. |\n| ws_kwargs | No | `{}` | Under the scenes, TikTokLive uses the [`websockets`](https://github.com/python-websockets/websockets) library to connect to TikTok. Arguments passed to `ws_kwargs` will be forwarded to the underlying WebSocket client. |\n\n## Methods\n\nA `TikTokLiveClient` object contains the following methods worth mentioning:\n\n| Method Name | Notes | Description |\n|--------------|---------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| run | N/A | Connect to the livestream and block the main thread. This is best for small scripts. |\n| add_listener | N/A | Adds an *asynchronous* listener function (or, you can decorate a function with `@client.on(Type[Event])`) and takes two parameters, an event name and the payload, an AbstractEvent ||\n| connect | `async` | Connects to the tiktok live chat while blocking the current future. When the connection ends (e.g. livestream is over), the future is released. |\n| start | `async` | Connects to the live chat without blocking the main thread. This returns an `asyncio.Task` object with the client loop. |\n| disconnect | `async` | Disconnects the client from the websocket gracefully, processing remaining events before ending the client loop. |\n\n## Properties\n\nA `TikTokLiveClient` object contains the following important properties:\n\n| Attribute Name | Description |\n|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| room_id | The Room ID of the livestream room the client is currently connected to. |\n| web | The TikTok HTTP client. This client has a lot of useful routes you should explore! |\n| connected | Whether you are currently connected to the livestream. |\n| logger | The internal logger used by TikTokLive. You can use `client.logger.setLevel(...)` method to enable client debug. |\n| room_info | Room information that is retrieved from TikTok when you use a connection method (e.g. `client.connect`) with the keyword argument `fetch_room_info=True` . |\n| gift_info | Extra gift information that is retrieved from TikTok when you use a connection method (e.g. `client.run`) with the keyword argument `fetch_gift_info=True`. |\n\n## WebDefaults\n\nTikTokLive has a series of global defaults used to create the HTTP client which you can customize. For info on how to set these parameters, see\nthe [web_defaults.py](https://github.com/isaackogan/TikTokLive/blob/master/examples/web_defaults.py) example.\n\n| Parameter | Type | Description |\n|-----------------------------|--------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| tiktok_sign_api_key | `str` | A [Euler Stream](https://www.eulerstream.com/) API key used to increase rate limits. |\n| tiktok_app_url | `str` | The TikTok app URL (`https://www.tiktok.com`) used to scrape the room. |\n| tiktok_sign_url | `str` | The [signature server](https://www.eulerstream.com/) used to generate tokens to connect to TikTokLive. By default, this is Euler Stream, but you can swap your own with ease. |\n| tiktok_webcast_url | `str` | The TikTok livestream URL (`https://webcast.tiktok.com`) where livestreams can be accessed from. |\n| web_client_params | `dict` | The URL parameters added on to TikTok requests from the HTTP client. |\n| web_client_headers | `dict` | The headers added on to TikTok requests from the HTTP client. |\n| web_client_cookies | `dict` | Custom cookies to initialize the http client with. |\n| ws_client_params | `dict` | The URL parameters added to the URI when connecting to TikTok's Webcast WebSocket server. |\n| ws_client_params_append_str | `dict` | Extra string data to append to the TikTokLive WebSocket connection URI. |\n| ws_client_headers | `dict` | Extra headers to append to the TikTokLive WebSocket client. |\n| ja3_impersonate | `str` | The ja3 fingerprint to impersonate. This should match whatever the current version is on the Sign Server, or \"privileged\" methods will fail. |\n\n## Events\n\nEvents can be listened to using a decorator or non-decorator method call. The following examples illustrate how you can listen to an event:\n\n```python\n@client.on(LikeEvent)\nasync def on_like(event: LikeEvent) -> None:\n ...\n\n\nasync def on_comment(event: CommentEvent) -> None:\n ...\n\n\nclient.add_listener(CommentEvent, on_comment)\n```\n\nThere are two types of events, [`CustomEvent`](https://github.com/isaackogan/TikTokLive/blob/master/TikTokLive/events/custom_events.py)\nevents and [`ProtoEvent`](https://github.com/isaackogan/TikTokLive/blob/master/TikTokLive/events/proto_events.py) events.\nBoth belong to the TikTokLive `Event` type and can be listened to. The following events are available:\n\n### Custom Events\n\n- `ConnectEvent` - Triggered when the Webcast connection is initiated\n- `DisconnectEvent` - Triggered when the Webcast connection closes (including the livestream ending)\n- `LiveEndEvent` - Triggered when the livestream ends\n- `LivePauseEvent` - Triggered when the livestream is paused\n- `LiveUnpauseEvent` - Triggered when the livestream is unpaused\n- `FollowEvent` - Triggered when a user in the livestream follows the streamer\n- `ShareEvent` - Triggered when a user shares the livestream\n- `WebsocketResponseEvent` - Triggered when any event is received (contains the event)\n- `UnknownEvent` - An instance of `WebsocketResponseEvent` thrown whenever an event does not have an existing definition, useful for debugging\n\n### Proto Events\n\nIf you know what an event does, [make a pull request](https://github.com/isaackogan/TikTokLive/pulls) and add the description.\n\n\n\n\n<details>\n<summary><h4>Proto Events</h4></summary>\n<ul>\n<li><code>GiftEvent</code> - Triggered when a gift is sent to the streamer</li>\n<li><code>GoalUpdateEvent</code> - Triggered when the subscriber goal is updated</li>\n<li><code>ControlEvent</code> - Triggered when a stream action occurs (e.g. Livestream start, end)</li>\n<li><code>LikeEvent</code> - Triggered when the stream receives a like</li>\n<li><code>SubscribeEvent</code> - Triggered when someone subscribes to the TikTok creator</li>\n<li><code>PollEvent</code> - Triggered when the creator launches a new poll</li>\n<li><code>CommentEvent</code> - Triggered when a comment is sent in the stream</li>\n<li><code>RoomEvent</code> - Messages broadcasted to all users in the room (e.g. \"Welcome to TikTok LIVE!\")</li>\n<li><code>EmoteChatEvent</code> - Triggered when a custom emote is sent in the chat</li>\n<li><code>EnvelopeEvent</code> - Triggered every time someone sends a treasure chest</li>\n<li><code>SocialEvent</code> - Triggered when a user shares the stream or follows the host</li>\n<li><code>QuestionNewEvent</code> - Triggered every time someone asks a new question via the question feature</li>\n<li><code>LiveIntroEvent</code> - Triggered when a live intro message appears</li>\n<li><code>LinkMicArmiesEvent</code> - Triggered when a TikTok battle user receives points</li>\n<li><code>LinkMicBattleEvent</code> - Triggered when a TikTok battle is started</li>\n<li><code>JoinEvent</code> - Triggered when a user joins the livestream</li>\n<li><code>LinkMicFanTicketMethodEvent</code></li>\n<li><code>LinkMicMethodEvent</code></li>\n<li><code>BarrageEvent</code> - Triggered when a \"VIP\" viewer (based on their gifting level) joins the live chat room</li>\n<li><code>CaptionEvent</code></li>\n<li><code>ImDeleteEvent</code> - Triggered when a viewer's messages are deleted</li>\n<li><code>RoomUserSeqEvent</code> - Current viewer count information</li>\n<li><code>RankUpdateEvent</code></li>\n<li><code>RankTextEvent</code> - Triggered when gift count makes a viewer one of the top three</li>\n<li><code>HourlyRankEvent</code></li>\n<li><code>UnauthorizedMemberEvent</code></li>\n<li><code>MessageDetectEvent</code></li>\n<li><code>OecLiveShoppingEvent</code></li>\n<li><code>RoomPinEvent</code> - Triggered when a message is pinned</li>\n<li><code>SystemEvent</code></li>\n<li><code>LinkEvent</code></li>\n<li><code>LinkLayerEvent</code></li>\n<li><code>KaraokeQueueListEvent</code></li>\n<li><code>GroupLiveMemberNotifyEvent</code></li>\n<li><code>SubscriptionGuideEvent</code></li>\n<li><code>NoticeboardReviewEvent</code></li>\n<li><code>BottomEvent</code></li>\n<li><code>CapsuleEvent</code></li>\n<li><code>LinkMicBattleEvent</code></li>\n<li><code>QuestionSelectedEvent</code></li>\n<li><code>TrayEvent</code></li>\n<li><code>AssetEvent</code></li>\n<li><code>WalletLiveRewardsRatioEvent</code></li>\n<li><code>LinkScreenChangeEvent</code></li>\n<li><code>PartnershipPunishEvent</code></li>\n<li><code>GiftPanelUpdateEvent</code></li>\n<li><code>AnchorTaskReminderEvent</code></li>\n<li><code>LinkBusinessEvent</code></li>\n<li><code>MarqueeAnnouncementEvent</code></li>\n<li><code>GiftDynamicRestrictionEvent</code></li>\n<li><code>CommonPopupEvent</code></li>\n<li><code>EcBarrageEvent</code></li>\n<li><code>PromoteAdStatusEvent</code></li>\n<li><code>InteractionHubGoalEvent</code></li>\n<li><code>EpiEvent</code></li>\n<li><code>LinkmicAnimationEvent</code></li>\n<li><code>KaraokeYouSingReqEvent</code></li>\n<li><code>RealTimePerformancePageEvent</code></li>\n<li><code>StreamStatusEvent</code></li>\n<li><code>GiftCollectionUpdateEvent</code></li>\n<li><code>CommercialCustomEvent</code></li>\n<li><code>GuideEvent</code></li>\n<li><code>DonationEvent</code></li>\n<li><code>LiveGameIntroEvent</code></li>\n<li><code>PartnershipDropsCardChangeEvent</code></li>\n<li><code>GameGuessWidgetsEvent</code></li>\n<li><code>MiddleTouchEvent</code></li>\n<li><code>UserStatsEvent</code></li>\n<li><code>WallpaperReviewEvent</code></li>\n<li><code>LinkMicAdEvent</code></li>\n<li><code>SubTimerStickerEvent</code></li>\n<li><code>GiftGalleryEvent</code></li>\n<li><code>GiftUpdateEvent</code></li>\n<li><code>NoticeboardEvent</code></li>\n<li><code>UpgradeEvent</code></li>\n<li><code>BackpackEvent</code></li>\n<li><code>AvatarStyleResultEvent</code></li>\n<li><code>GameSettingChangeEvent</code></li>\n<li><code>PartnershipDropsUpdateEvent</code></li>\n<li><code>QuestionSwitchEvent</code></li>\n<li><code>LiveInfoAuditNoticeEvent</code></li>\n<li><code>CommonToastEvent</code></li>\n<li><code>ToastEvent</code></li>\n<li><code>DonationStickerModifyMethodEvent</code></li>\n<li><code>PollEvent</code></li>\n<li><code>HighlightFragementReadyEvent</code></li>\n<li><code>GiftPromptEvent</code></li>\n<li><code>ForceFetchRecommendationsEvent</code></li>\n<li><code>GameGuessPinCardEvent</code></li>\n<li><code>LinkLayoutEvent</code></li>\n<li><code>GameOcrPingEvent</code></li>\n<li><code>AnchorGrowLevelEvent</code></li>\n<li><code>EnvelopePortalEvent</code></li>\n<li><code>CohostReserveEvent</code></li>\n<li><code>BaLeadGenEvent</code></li>\n<li><code>PictionaryEndEvent</code></li>\n<li><code>RoomNotifyEvent</code></li>\n<li><code>FansEventEvent</code></li>\n<li><code>KaraokeQueueEvent</code></li>\n<li><code>FollowCardEvent</code></li>\n<li><code>ActivityQuizUserIdentityEvent</code></li>\n<li><code>LiveJourneyEvent</code></li>\n<li><code>CommentsEvent</code></li>\n<li><code>WeeklyRankRewardEvent</code></li>\n<li><code>LinkStateEvent</code></li>\n<li><code>AccessRecallEvent</code></li>\n<li><code>AiSummaryEvent</code></li>\n<li><code>PerceptionEvent</code></li>\n<li><code>RoomVerifyEvent</code></li>\n<li><code>GuideTaskEvent</code></li>\n<li><code>VideoLiveCouponRcmdEvent</code></li>\n<li><code>VideoLiveGoodsRcmdEvent</code></li>\n<li><code>KaraokeSwitchEvent</code></li>\n<li><code>PrivilegeAdvanceEvent</code></li>\n<li><code>LinkMicBattlePunishFinishEvent</code></li>\n<li><code>BoostedUsersEvent</code></li>\n<li><code>RankToastEvent</code></li>\n<li><code>CommentTrayEvent</code></li>\n<li><code>AnchorReminderWordEvent</code></li>\n<li><code>PaidContentLiveShoppingEvent</code></li>\n<li><code>RoomEventEvent</code></li>\n<li><code>RoomBottomEvent</code></li>\n<li><code>DonationInfoEvent</code></li>\n<li><code>GameMomentEvent</code></li>\n<li><code>HashtagEvent</code></li>\n<li><code>LinkMicBattleItemCardEvent</code></li>\n<li><code>PrivilegeDynamicEffectEvent</code></li>\n<li><code>AnchorGetSubQuotaEvent</code></li>\n<li><code>OecLiveHotRoomEvent</code></li>\n<li><code>AudienceReserveUserStateEvent</code></li>\n<li><code>RealtimeLiveCenterMethodEvent</code></li>\n<li><code>WallpaperEvent</code></li>\n<li><code>SubPinEventEvent</code></li>\n<li><code>LinkmicBattleTaskEvent</code></li>\n<li><code>StarCommentPushEvent</code></li>\n<li><code>EcTaskRefreshCouponListEvent</code></li>\n<li><code>ShortTouchEvent</code></li>\n<li><code>EffectControlEvent</code></li>\n<li><code>KaraokeRedDotEvent</code></li>\n<li><code>QuestionDeleteEvent</code></li>\n<li><code>InRoomBannerEvent</code></li>\n<li><code>ShareGuideEvent</code></li>\n<li><code>EventEvent</code></li>\n<li><code>InRoomBannerEventEvent</code></li>\n<li><code>PlayTogetherEvent</code></li>\n<li><code>SubContractStatusEvent</code></li>\n<li><code>HourlyRankRewardEvent</code></li>\n<li><code>PictionaryStartEvent</code></li>\n<li><code>GuestInviteEvent</code></li>\n<li><code>NoticeEvent</code></li>\n<li><code>PartnershipDownloadCountEvent</code></li>\n<li><code>GreetingEvent</code></li>\n<li><code>LiveShowEvent</code></li>\n<li><code>SubWaveEvent</code></li>\n<li><code>GameReqSetGuessEvent</code></li>\n<li><code>SpeakerEvent</code></li>\n<li><code>LinkMicAnchorGuideEvent</code></li>\n<li><code>CompetitionEvent</code></li>\n<li><code>AvatarReportDeleteEvent</code></li>\n<li><code>EffectPreloadingEvent</code></li>\n<li><code>ColdStartEvent</code></li>\n<li><code>CountdownForAllEvent</code></li>\n<li><code>GiftBroadcastEvent</code></li>\n<li><code>PreviewGameMomentEvent</code></li>\n<li><code>GameRecommendCreateGuessEvent</code></li>\n<li><code>VideoLiveGoodsOrderEvent</code></li>\n<li><code>StarCommentNotificationEvent</code></li>\n<li><code>InRoomBannerRefreshEvent</code></li>\n<li><code>RoomStickerEvent</code></li>\n<li><code>GiftProgressEvent</code></li>\n<li><code>OecLiveManagerEvent</code></li>\n<li><code>DiggEvent</code></li>\n<li><code>AiLiveSummaryEvent</code></li>\n<li><code>AnchorToolModificationEvent</code></li>\n<li><code>MgPunishCenterActionEvent</code></li>\n<li><code>PictionaryExitEvent</code></li>\n<li><code>CountdownEvent</code></li>\n<li><code>GameServerFeatureEvent</code></li>\n<li><code>PlaybookEvent</code></li>\n<li><code>GiftRecordCapsuleEvent</code></li>\n<li><code>QuickChatListEvent</code></li>\n<li><code>PartnershipCardChangeEvent</code></li>\n<li><code>ScreenChatEvent</code></li>\n<li><code>GameEmoteUpdateEvent</code></li>\n<li><code>BoostCardEvent</code></li>\n<li><code>RoomStreamAdaptationEvent</code></li>\n<li><code>LinkmicBattleNoticeEvent</code></li>\n<li><code>GoodyBagEvent</code></li>\n</ul>\n</details>\n\n### Special Events\n\n### `GiftEvent`\n\nTriggered every time a gift arrives. Extra information can be gleamed from the `available_gifts` client attribute.\n> **NOTE:** Users have the capability to send gifts in a streak. This increases the `event.gift.repeat_count` value until the\n> user terminates the streak. During this time new gift events are triggered again and again with an\n> increased `event.gift.repeat_count` value. It should be noted that after the end of a streak, a final gift event is\n> triggered, which signals the end of the streak with `event.repeat_end`:`1`. The following handlers show how you can deal with this in your code.\n\nUsing the low-level direct proto:\n\n```python\n@client.on(GiftEvent)\nasync def on_gift(event: GiftEvent):\n # If it's type 1 and the streak is over\n if event.gift.info.type == 1:\n if event.gift.is_repeating == 1:\n print(f\"{event.user.unique_id} sent {event.repeat_count}x \\\"{event.gift.name}\\\"\")\n\n # It's not type 1, which means it can't have a streak & is automatically over\n elif event.gift.info.type != 1:\n print(f\"{event.user.unique_id} sent \\\"{event.gift.name}\\\"\")\n```\n\nUsing the TikTokLive extended proto:\n\n```python\n@client.on(\"gift\")\nasync def on_gift(event: GiftEvent):\n # Streakable gift & streak is over\n if event.gift.streakable and not event.streaking:\n print(f\"{event.user.unique_id} sent {event.repeat_count}x \\\"{event.gift.name}\\\"\")\n\n # Non-streakable gift\n elif not event.gift.streakable:\n print(f\"{event.user.unique_id} sent \\\"{event.gift.name}\\\"\")\n```\n\n### `SubscribeEvent`\n\nThis event will only fire when a session ID (account login) is passed to the HTTP client *before* connecting to TikTok LIVE.\nYou can set the session ID with [`client.web.set_session_id(...)`](https://github.com/isaackogan/TikTokLive/blob/master/examples/logged_in.py).\n\n## Checking If A User Is Live\n\nIt is considered inefficient to use the connect method to check if a user is live. It is better to use the dedicated `await client.is_live()` method.\n\nThere is a [complete example](https://github.com/isaackogan/TikTokLive/blob/master/examples/check_live.py) of how to do this in the [examples](https://github.com/isaackogan/TikTokLive/tree/master/examples) folder.\n\n## Star History\n\n<p align=\"center\">\n <img alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=isaackogan/TikTokLive&type=Date&theme=dark\" onerror=\"this.src='https://api.star-history.com/svg?repos=isaackogan/TikTokLive&type=Date'\" />\n</p>\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Contributors\n\n* **Isaac Kogan** - *Creator, Primary Maintainer, and Reverse-Engineering* - [isaackogan](https://github.com/isaackogan)\n* **Zerody** - *Creator of the NodeJS library, introduced me to scraping TikTok LIVE* - [Zerody](https://github.com/zerodytrash/)\n\nSee also the full list of secondary [contributors](https://github.com/isaackogan/TikTokLive/contributors) who have participated in\nthis project.\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "TikTok Live Python Client",
"version": "6.6.5",
"project_urls": {
"Homepage": "https://github.com/isaackogan/TikTokLive"
},
"split_keywords": [
"tiktok",
" tiktok live",
" python3",
" api",
" unofficial"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "3a292ace0f2017df243df94848b224d48a3dd1e949197503bb4141d9cf0dacbe",
"md5": "517b9dee5e5b53f57a59fe566cdb75bc",
"sha256": "9d7b2f4fa1ca4e4a86b70d741e0a7a3b2d856c9397e78ed2328c25a8e634490e"
},
"downloads": -1,
"filename": "tiktoklive-6.6.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "517b9dee5e5b53f57a59fe566cdb75bc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 199848,
"upload_time": "2025-10-08T02:08:54",
"upload_time_iso_8601": "2025-10-08T02:08:54.223319Z",
"url": "https://files.pythonhosted.org/packages/3a/29/2ace0f2017df243df94848b224d48a3dd1e949197503bb4141d9cf0dacbe/tiktoklive-6.6.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2809295a05e92df26419665b78aad58516e4492ea1c6283bc0f1bfc7c19c46fb",
"md5": "494521f86752ec0006e5b2a022c21dbe",
"sha256": "fd83aa0ce5b506ab1b8c3bde7758abab075d0ca1f4fc3057c1fbb6474112221b"
},
"downloads": -1,
"filename": "tiktoklive-6.6.5.tar.gz",
"has_sig": false,
"md5_digest": "494521f86752ec0006e5b2a022c21dbe",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 190538,
"upload_time": "2025-10-08T02:08:55",
"upload_time_iso_8601": "2025-10-08T02:08:55.630214Z",
"url": "https://files.pythonhosted.org/packages/28/09/295a05e92df26419665b78aad58516e4492ea1c6283bc0f1bfc7c19c46fb/tiktoklive-6.6.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-08 02:08:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "isaackogan",
"github_project": "TikTokLive",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "async-timeout",
"specs": [
[
">=",
"4.0.3"
]
]
},
{
"name": "jinja2",
"specs": []
},
{
"name": "python-dotenv",
"specs": []
}
],
"lcname": "tiktoklive"
}
JSON
