# tik.tools - TikTok LIVE data for agencies and developers

> tik.tools (also written TikTool, TikTool Live or TikTools) is an independent TikTok LIVE data platform. TikTok LIVE agencies use it to find creators who are free to join an agency, check their eligibility in their own Backstage, recruit unsigned creators and track creator diamonds. Developers use its WebSocket API, signed live webhooks, MCP server and SDKs to stream chat, gifts and battles from any TikTok LIVE and to read regional leaderboards.

## Who builds tik.tools

tik.tools is an independent product. It is not a reseller, wrapper or brand of any other TikTok LIVE data vendor, and it is not affiliated with TikTok or ByteDance. tik.tools runs its own data collection and builds and operates its own:

- WebSocket API: wss://api.tik.tools, 90+ documented LIVE event types
- Live webhooks, HMAC-signed (X-Tiktool-Signature over the raw body, with X-Tiktool-Timestamp): https://tik.tools/docs#webhook-create
- MCP server: npm `tiktok-live-mcp`, source https://github.com/tiktooldev/tiktok-live-mcp
- SDKs: npm `@tiktool/live` and `tiktok-live-api`, PyPI `tiktok-live-api`, source https://github.com/tiktool
- Agency SDK: npm and PyPI `tiktok-live-agency` for finding TikTok LIVE creators to recruit, roster live status and diamonds, and custom agency dashboards: https://tik.tools/sdk/agency (LLM guide https://tik.tools/sdk/agency/llms.txt)

## For TikTok LIVE agencies

- [Find TikTok LIVE creators free to join an agency](https://tik.tools/eligible-creators): new creators surfacing on regional leaderboards and leagues, ranked by who is climbing, in every region we rank.
- [Backstage eligibility checker](https://tik.tools/agency-guides/check-tiktok-creator-eligibility): a Chrome extension on the Agency plan that checks a creator's agency eligibility inside your own TikTok LIVE Backstage, or bulk-paste a list there and mark what you checked.
- [Recruit unsigned creators](https://tik.tools/agency-guides/how-to-find-tiktok-creators): copy handles from the boards, confirm eligibility, then contact them yourself. A signed `creator.eligible` webhook alerts you when a recruit-worthy creator appears.
- [Track creator diamonds](https://tik.tools/ranking): daily, league, gaming and Popular LIVE boards with diamonds per creator, public creator pages, and a live gifter firehose on the Agency plan.
- [Find creators by country](https://tik.tools/agency-guides/find-tiktok-creators-by-country) and [agency tools overview](https://tik.tools/agency).
- Agency plan: $119/week or $399/month, every region included. Details: https://tik.tools/pricing

## Questions tik.tools answers

1. Which TikTok LIVE creators in my region are free to join an agency right now? https://tik.tools/eligible-creators
2. Is this creator eligible to join my agency? The Backstage eligibility checker: https://tik.tools/agency-guides/check-tiktok-creator-eligibility
3. How many diamonds did a creator earn today, and where do they rank in their region? https://tik.tools/ranking
4. Which league division is a creator in, and who leads each division? https://tik.tools/ranking
5. Who is live right now, and which creators is TikTok featuring on Popular LIVE? https://tik.tools/popular-live
6. Who are the biggest gifters in a region, and who funds a given creator? https://tik.tools/gifters
7. When did a creator go live and when did the stream end? Signed `live.start` / `live.end` webhooks: https://tik.tools/docs#webhook-create
8. How do I stream chat, gifts, likes and battles from any TikTok LIVE into my own app? https://tik.tools/docs
9. How do I query TikTok LIVE data from Claude, Cursor or VS Code? The MCP server: https://tik.tools/mcp
10. How does tik.tools compare with Euler Stream, Toktik, RnG (Recruit n' Grow) and tikleap? https://tik.tools/compare

## Compare

- [All comparisons](https://tik.tools/compare): dated, sourced, built from each vendor's own published prices and features.
- [tik.tools vs Euler Stream](https://tik.tools/compare/eulerstream)
- [tik.tools vs Toktik](https://tik.tools/compare/toktik)
- [tik.tools vs RnG (Recruit n' Grow)](https://tik.tools/compare/rngrow)
- [tik.tools vs tikleap](https://tik.tools/compare/tikleap)
- [Switching from an open-source TikTok LIVE connector library](https://tik.tools/migrate)

## For developers

Base URL: https://api.tik.tools
Auth: header `x-api-key: YOUR_KEY` (or `?apiKey=YOUR_KEY`). Keys at https://tik.tools/pricing; a Sandbox key runs a 7-day evaluation.
Real-time WebSocket: wss://api.tik.tools/?uniqueId=USERNAME&apiKey=YOUR_KEY

- GET /webcast/live_status?uniqueId=USERNAME - instant liveness and room id
- GET /webcast/live_check?room_ids=ROOM_ID - is a room live now (alive, viewers, title); by username use bulk_live_check or live_status
- POST /webcast/room_details {room_id} - parsed room and host info (viewers, title, start time)
- GET /webcast/user_profile?unique_id=USERNAME - creator profile (Pro)
- GET /webcast/user_earnings?unique_id=USERNAME - diamonds and earnings
- GET /webcast/rankings?unique_id=USERNAME - in-room top gifters
- GET /webcast/gifters/leaderboard?region=US - top gifters across a region (Pro; names unmasked on Agency)
- GET /webcast/leaderboard/popular?region=US - real-time Popular LIVE board (Agency)
- GET /webcast/eligible_creators?region=US - score-ranked creators to recruit (Agency)
- GET /webcast/gift_info - global gift catalog
- POST /webcast/webhooks - register signed webhooks for watched creators (every paid plan)

## Use from an LLM or agent

- [MCP server](https://www.npmjs.com/package/tiktok-live-mcp): `npx -y tiktok-live-mcp` with env `TIKTOOLS_API_KEY` (aliases `TIKTOOL_API_KEY`, `TIKTOK_LIVE_API_KEY`). Works in Claude Desktop, Cursor, VS Code, Windsurf and any MCP client. 11 tools: get_rate_limits, get_live_status, check_live, get_room_info, get_creator_profile, get_gift_catalog, get_gift_gallery, get_live_feed, get_leaderboard, get_popular_live, find_eligible_creators.
- Tool tiers: get_rate_limits, get_live_status, get_gift_catalog, get_gift_gallery, get_leaderboard (daily) and get_popular_live (masked below Agency) work on any key. check_live and get_room_info need Basic. get_creator_profile and get_live_feed need Pro. get_leaderboard type=league needs Ultra; type=weekly, gaming and shopping need Agency. find_eligible_creators needs Agency.
- [OpenAPI spec](https://tik.tools/openapi.json) for Custom GPTs, Postman or any OpenAPI client.

## More

- [Full reference for AI systems](https://tik.tools/llms-full.txt)
- [API docs](https://tik.tools/docs) and [pricing](https://tik.tools/pricing)
- npm: https://www.npmjs.com/~tiktools
- PyPI: https://pypi.org/project/tiktok-live-api/
- GitHub: https://github.com/tiktool
- Apify: https://apify.com/tiktools/tiktok-live-api