{"adoption": {"forks": 289, "observed_at": "2026-08-28T04:04:59.819784+00:00", "stars": 1535}, "canonical_url": "https://ross.abutalabs.com/products/tiktoklive", "card": {"archived": false, "artifact_type": "library", "description": "TikTok LIVE API for Python: The definitive 3rd-party library to receive livestream events (comments, gifts, etc.) in realtime from TikTok LIVE.", "domain": ["social-media", "apis", "media"], "enriched": true, "function": ["websocket", "http-client", "sdk", "chatbot"], "health_score": 89, "homepage": "https://isaackogan.github.io/TikTokLive/", "language": "Python", "license": "AGPL-3.0", "license_family": "copyleft", "maturity": "active", "member_repos": ["isaackogan/TikTokLive"], "name": "isaackogan/TikTokLive", "platform": ["python", "cross-platform"], "pushed_at": "2026-08-18T04:26:25+00:00", "repo": "isaackogan/TikTokLive", "stars": 1535, "tags": ["tiktok", "livestreaming", "reverse-engineering", "unofficial-api", "live-chat", "gift-tracking", "streaming-events", "obs-overlays", "real-time", "automation", "nodejs"], "topics": ["tiktok", "tiktok-live", "tiktok-api", "python", "tiktok-live-api", "live-chat", "live-streaming", "nodejs", "speech-to-text", "tiktok-bot", "tiktok-chat", "tiktok-events", "tiktok-live-connector", "tiktok-live-streams", "tiktok-stream", "tiktok-websocket", "typescript", "webcast", "websocket", "tiktok-gift"], "urls": [], "use_cases": ["read tiktok live chat comments in real time with python", "build a tiktok gift tracker or donation alert bot", "create OBS overlays driven by tiktok live events", "track viewer counts, likes, and battle scores for tiktok streams", "make a tiktok live chat bot that responds to comments", "build text-to-speech readers for tiktok livestreams", "moderate tiktok live rooms by reacting to deleted messages"], "what_it_is": "TikTokLive is an unofficial Python library that connects to any TikTok LIVE stream via a creator's @unique_id and receives real-time events such as comments, gifts, likes, follows, shares, viewer counts, and battles over the Webcast websocket. It is a reverse-engineering project (not a supported vendor API) intended for building chat bots, gift trackers, overlays, and analytics tools.", "when_to_avoid": ["you need guaranteed production uptime, since TikTok can change the Webcast protocol without notice", "you require an officially supported or vendor-backed API", "your project cannot comply with the AGPL-3.0 license"], "when_to_choose": ["you need real-time TikTok LIVE events in Python without login or credentials", "you are building bots, overlays, alerts, or analytics on top of TikTok livestreams", "you want a free, self-hosted alternative to managed TikTok LIVE APIs"]}, "data_as_of": "2026-08-30T08:39:29.467469+00:00", "members": [{"path": "/products/tiktoklive", "repo": "isaackogan/TikTokLive", "role": "main", "score": 78}], "provenance": {"archived": {"kind": "observed", "observed_at": "2026-08-28T04:04:59.819784+00:00", "source": "github"}, "artifact_type": {"confidence": null, "enriched_at": "2026-08-30T04:31:09.387634+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1a67baf2f93dfb456b915c655ba4d793c3d8e8dd8d9896b97c9ff22e8f9dff7e", "fetched_at": "2026-08-28T04:04:59.819784+00:00", "kind": "readme", "missing": false, "url": "https://github.com/isaackogan/TikTokLive"}, {"content_hash": "b2eda7a5c102fd2aa9a2a42761de0b1dc805d2b3e4cf6227503e244d0d68d027", "fetched_at": "2026-08-29T11:33:08.818128+00:00", "kind": "homepage", "missing": false, "url": "https://isaackogan.github.io/TikTokLive/"}, {"content_hash": "4beacbb0ca2a219a0b51cce9ce71612919bb5573e78485cb44e67769b17cdf6f", "fetched_at": "2026-08-29T11:33:08.828128+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/tiktoklive/json"}], "taxonomy_version": 1}, "description": {"kind": "observed", "observed_at": "2026-08-28T04:04:59.819784+00:00", "source": "github"}, "domain": {"confidence": null, "enriched_at": "2026-08-30T04:31:09.387634+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1a67baf2f93dfb456b915c655ba4d793c3d8e8dd8d9896b97c9ff22e8f9dff7e", "fetched_at": "2026-08-28T04:04:59.819784+00:00", "kind": "readme", "missing": false, "url": "https://github.com/isaackogan/TikTokLive"}, {"content_hash": "b2eda7a5c102fd2aa9a2a42761de0b1dc805d2b3e4cf6227503e244d0d68d027", "fetched_at": "2026-08-29T11:33:08.818128+00:00", "kind": "homepage", "missing": false, "url": "https://isaackogan.github.io/TikTokLive/"}, {"content_hash": "4beacbb0ca2a219a0b51cce9ce71612919bb5573e78485cb44e67769b17cdf6f", "fetched_at": "2026-08-29T11:33:08.828128+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/tiktoklive/json"}], "taxonomy_version": 1}, "enriched": {"inputs": [], "kind": "computed", "method": "enrichment_status"}, "function": {"confidence": null, "enriched_at": "2026-08-30T04:31:09.387634+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1a67baf2f93dfb456b915c655ba4d793c3d8e8dd8d9896b97c9ff22e8f9dff7e", "fetched_at": "2026-08-28T04:04:59.819784+00:00", "kind": "readme", "missing": false, "url": "https://github.com/isaackogan/TikTokLive"}, {"content_hash": "b2eda7a5c102fd2aa9a2a42761de0b1dc805d2b3e4cf6227503e244d0d68d027", "fetched_at": "2026-08-29T11:33:08.818128+00:00", "kind": "homepage", "missing": false, "url": "https://isaackogan.github.io/TikTokLive/"}, {"content_hash": "4beacbb0ca2a219a0b51cce9ce71612919bb5573e78485cb44e67769b17cdf6f", "fetched_at": "2026-08-29T11:33:08.828128+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/tiktoklive/json"}], "taxonomy_version": 1}, "health_score": {"inputs": ["days_since_push", "days_since_release", "archived"], "kind": "computed", "method": "health_v1"}, "homepage": {"kind": "observed", "observed_at": "2026-08-28T04:04:59.819784+00:00", "source": "github"}, "language": {"kind": "observed", "observed_at": "2026-08-28T04:04:59.819784+00:00", "source": "github"}, "license": {"kind": "observed", "observed_at": "2026-08-28T04:04:59.819784+00:00", "source": "github"}, "license_family": {"inputs": ["license"], "kind": "computed", "method": "license_family"}, "maturity": {"confidence": null, "enriched_at": "2026-08-30T04:31:09.387634+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1a67baf2f93dfb456b915c655ba4d793c3d8e8dd8d9896b97c9ff22e8f9dff7e", "fetched_at": "2026-08-28T04:04:59.819784+00:00", "kind": "readme", "missing": false, "url": "https://github.com/isaackogan/TikTokLive"}, {"content_hash": "b2eda7a5c102fd2aa9a2a42761de0b1dc805d2b3e4cf6227503e244d0d68d027", "fetched_at": "2026-08-29T11:33:08.818128+00:00", "kind": "homepage", "missing": false, "url": "https://isaackogan.github.io/TikTokLive/"}, {"content_hash": "4beacbb0ca2a219a0b51cce9ce71612919bb5573e78485cb44e67769b17cdf6f", "fetched_at": "2026-08-29T11:33:08.828128+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/tiktoklive/json"}], "taxonomy_version": 1}, "member_repos": {"kind": "observed", "observed_at": "2026-08-28T04:04:59.819784+00:00", "source": "github"}, "name": {"kind": "observed", "observed_at": "2026-08-28T04:04:59.819784+00:00", "source": "github"}, "platform": {"confidence": null, "enriched_at": "2026-08-30T04:31:09.387634+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1a67baf2f93dfb456b915c655ba4d793c3d8e8dd8d9896b97c9ff22e8f9dff7e", "fetched_at": "2026-08-28T04:04:59.819784+00:00", "kind": "readme", "missing": false, "url": "https://github.com/isaackogan/TikTokLive"}, {"content_hash": "b2eda7a5c102fd2aa9a2a42761de0b1dc805d2b3e4cf6227503e244d0d68d027", "fetched_at": "2026-08-29T11:33:08.818128+00:00", "kind": "homepage", "missing": false, "url": "https://isaackogan.github.io/TikTokLive/"}, {"content_hash": "4beacbb0ca2a219a0b51cce9ce71612919bb5573e78485cb44e67769b17cdf6f", "fetched_at": "2026-08-29T11:33:08.828128+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/tiktoklive/json"}], "taxonomy_version": 1}, "pushed_at": {"kind": "observed", "observed_at": "2026-08-28T04:04:59.819784+00:00", "source": "github"}, "repo": {"kind": "observed", "observed_at": "2026-08-28T04:04:59.819784+00:00", "source": "github"}, "stars": {"kind": "observed", "observed_at": "2026-08-28T04:04:59.819784+00:00", "source": "github"}, "tags": {"confidence": null, "enriched_at": "2026-08-30T04:31:09.387634+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1a67baf2f93dfb456b915c655ba4d793c3d8e8dd8d9896b97c9ff22e8f9dff7e", "fetched_at": "2026-08-28T04:04:59.819784+00:00", "kind": "readme", "missing": false, "url": "https://github.com/isaackogan/TikTokLive"}, {"content_hash": "b2eda7a5c102fd2aa9a2a42761de0b1dc805d2b3e4cf6227503e244d0d68d027", "fetched_at": "2026-08-29T11:33:08.818128+00:00", "kind": "homepage", "missing": false, "url": "https://isaackogan.github.io/TikTokLive/"}, {"content_hash": "4beacbb0ca2a219a0b51cce9ce71612919bb5573e78485cb44e67769b17cdf6f", "fetched_at": "2026-08-29T11:33:08.828128+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/tiktoklive/json"}], "taxonomy_version": 1}, "topics": {"kind": "observed", "observed_at": "2026-08-28T04:04:59.819784+00:00", "source": "github"}, "urls": {"kind": "observed", "observed_at": "2026-08-28T04:04:59.819784+00:00", "source": "github"}, "use_cases": {"confidence": null, "enriched_at": "2026-08-30T04:31:09.387634+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1a67baf2f93dfb456b915c655ba4d793c3d8e8dd8d9896b97c9ff22e8f9dff7e", "fetched_at": "2026-08-28T04:04:59.819784+00:00", "kind": "readme", "missing": false, "url": "https://github.com/isaackogan/TikTokLive"}, {"content_hash": "b2eda7a5c102fd2aa9a2a42761de0b1dc805d2b3e4cf6227503e244d0d68d027", "fetched_at": "2026-08-29T11:33:08.818128+00:00", "kind": "homepage", "missing": false, "url": "https://isaackogan.github.io/TikTokLive/"}, {"content_hash": "4beacbb0ca2a219a0b51cce9ce71612919bb5573e78485cb44e67769b17cdf6f", "fetched_at": "2026-08-29T11:33:08.828128+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/tiktoklive/json"}], "taxonomy_version": 1}, "what_it_is": {"confidence": null, "enriched_at": "2026-08-30T04:31:09.387634+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1a67baf2f93dfb456b915c655ba4d793c3d8e8dd8d9896b97c9ff22e8f9dff7e", "fetched_at": "2026-08-28T04:04:59.819784+00:00", "kind": "readme", "missing": false, "url": "https://github.com/isaackogan/TikTokLive"}, {"content_hash": "b2eda7a5c102fd2aa9a2a42761de0b1dc805d2b3e4cf6227503e244d0d68d027", "fetched_at": "2026-08-29T11:33:08.818128+00:00", "kind": "homepage", "missing": false, "url": "https://isaackogan.github.io/TikTokLive/"}, {"content_hash": "4beacbb0ca2a219a0b51cce9ce71612919bb5573e78485cb44e67769b17cdf6f", "fetched_at": "2026-08-29T11:33:08.828128+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/tiktoklive/json"}], "taxonomy_version": 1}, "when_to_avoid": {"confidence": null, "enriched_at": "2026-08-30T04:31:09.387634+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1a67baf2f93dfb456b915c655ba4d793c3d8e8dd8d9896b97c9ff22e8f9dff7e", "fetched_at": "2026-08-28T04:04:59.819784+00:00", "kind": "readme", "missing": false, "url": "https://github.com/isaackogan/TikTokLive"}, {"content_hash": "b2eda7a5c102fd2aa9a2a42761de0b1dc805d2b3e4cf6227503e244d0d68d027", "fetched_at": "2026-08-29T11:33:08.818128+00:00", "kind": "homepage", "missing": false, "url": "https://isaackogan.github.io/TikTokLive/"}, {"content_hash": "4beacbb0ca2a219a0b51cce9ce71612919bb5573e78485cb44e67769b17cdf6f", "fetched_at": "2026-08-29T11:33:08.828128+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/tiktoklive/json"}], "taxonomy_version": 1}, "when_to_choose": {"confidence": null, "enriched_at": "2026-08-30T04:31:09.387634+00:00", "kind": "inferred", "prompt_version": 1, "sources": [{"content_hash": "1a67baf2f93dfb456b915c655ba4d793c3d8e8dd8d9896b97c9ff22e8f9dff7e", "fetched_at": "2026-08-28T04:04:59.819784+00:00", "kind": "readme", "missing": false, "url": "https://github.com/isaackogan/TikTokLive"}, {"content_hash": "b2eda7a5c102fd2aa9a2a42761de0b1dc805d2b3e4cf6227503e244d0d68d027", "fetched_at": "2026-08-29T11:33:08.818128+00:00", "kind": "homepage", "missing": false, "url": "https://isaackogan.github.io/TikTokLive/"}, {"content_hash": "4beacbb0ca2a219a0b51cce9ce71612919bb5573e78485cb44e67769b17cdf6f", "fetched_at": "2026-08-29T11:33:08.828128+00:00", "kind": "registry_pypi", "missing": false, "url": "https://pypi.org/pypi/tiktoklive/json"}], "taxonomy_version": 1}}, "score": {"components": {"activity": 98, "longevity": 100, "rhythm": 40}, "computed_at": "2026-09-03T02:20:16.233290+00:00", "flags": [], "formula": "round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)", "inputs": {"age_days": 1652, "days_push": 15, "days_rel": 613, "gap_med": 5, "n_releases_24m": 6}, "score": 78, "version": 2}, "staleness": {"enrichment_outdated": false, "low_confidence": false, "scrape_days": 9, "stale_scrape": false}}