@tiktool/live 2.11.2 → 2.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +24 -7
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -401,15 +401,32 @@ Returns full profile JSON. Pro tier and above. Cached server-side for 24h — re
401
401
 
402
402
  All API requests require an API key. Get yours at [tik.tools](https://tik.tools).
403
403
 
404
- | Tier | Price (USD / week) | WS Connections | Rate limit |
405
- |------|--------------------|----------------|------------|
406
- | **Free** | $0 | 1 | 5 req/min |
407
- | **Basic** | $9 | 25 | 30 req/min |
408
- | **Pro** | $19 | 100 | 120 req/min |
409
- | **Ultra** | $58 | 250 | 600 req/min |
404
+ | Tier | Price | Requests/day | WS Connections | Notes |
405
+ |------|-------|--------------|----------------|-------|
406
+ | **Community** | Free forever | 2,500 | 15 (no time limit) | Masked leaderboards. No datacenter proxies — calls run from your own IP. |
407
+ | **Pro** | from $59/mo | 75,000 | 50 (8h) | Unmasked leaderboards · CAPTCHA Solver · Feed Discovery · 5 AI caption streams · priority routing |
408
+ | **Ultra** | from $219/mo | 300,000 | 250 (8h) | Unmasked leagues · 20 AI caption streams · 99.5% uptime SLA · priority chat support |
409
+ | **Global Agency** | $549/mo | 300,000 | 500 + Firehose | Everything in Ultra + **Live Gifter Firehose WS** (region/league/global + min-diamond filters) + VIP Telegram alerts + VIP Web Vault |
410
410
 
411
411
  The SDK calls the sign server **once per connection**, then stays connected
412
- via WebSocket. A free key is sufficient for most use cases.
412
+ via WebSocket. The free Community tier has no per-connection time limit and
413
+ is sufficient for most use cases.
414
+
415
+ ### Live Gifter Firehose — Global Agency
416
+
417
+ Real-time gift event stream from Dragonfly fan-out. Filter by region, league,
418
+ or globally; cap by minimum diamond threshold. Mid-stream filter updates
419
+ supported via `update_filter` frame.
420
+
421
+ ```js
422
+ const ws = new WebSocket(
423
+ `wss://api.tik.tools/firehose/gifters?apiKey=${KEY}&mode=region&region=US%2B&min_diamonds=1000`
424
+ )
425
+ ws.on('message', (raw) => {
426
+ const evt = JSON.parse(raw)
427
+ // evt: { type:'gifter_alert', ts, gifter, creator, gift, region }
428
+ })
429
+ ```
413
430
 
414
431
  ---
415
432
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tiktool/live",
3
- "version": "2.11.2",
3
+ "version": "2.12.0",
4
4
  "description": "TikTok LIVE API Client — Real-time chat, gifts, viewers, PK battles with MVP breakdown, x2/x3 boosters, gloves, mist, match-guide & 20+ event types from any TikTok livestream. Direct WebSocket connection.",
5
5
  "author": "tiktool",
6
6
  "license": "MIT",