# tikstat: agent guide

## Start here
- Site map: https://localhost:3000/llms.txt
- API spec: https://localhost:3000/openapi.json

## What you can do without an account
- Home: https://localhost:3000/
- Pricing: https://localhost:3000/pricing
- Watch: https://localhost:3000/watch
- Creator directory: https://localhost:3000/watch/browse/a
- Leaderboard: https://localhost:3000/leaderboard
- Rich list: https://localhost:3000/rich-list
- One creator: https://localhost:3000/watch/{handle}
- Gift prices: https://localhost:3000/gifts
- One gift: https://localhost:3000/gifts/{name}
- Diamonds to USD: https://localhost:3000/diamonds
- A diamond amount: https://localhost:3000/diamonds/{amount}
- Coins to USD: https://localhost:3000/coins
- Live monitor: https://localhost:3000/live-monitor
- Live statistics: https://localhost:3000/tiktok-live-statistics
- Methodology: https://localhost:3000/methodology
- Guides: https://localhost:3000/guides
- Glossary: https://localhost:3000/glossary
- Docs: https://localhost:3000/docs
- Help center: https://localhost:3000/help
- Contact: https://localhost:3000/contact
- Changelog: https://localhost:3000/changelog
- Privacy Policy: https://localhost:3000/legal/privacy-policy
- Terms of Service: https://localhost:3000/legal/terms
- Copyright Policy: https://localhost:3000/legal/copyright
- Sign up: https://localhost:3000/signup
- Sign in: https://localhost:3000/login
- Check whether a creator is live: `GET https://localhost:3000/api/lookup?handle={handle}`

## What needs an account
The app at https://localhost:3000/app (tracking creators, alerts, recaps, recordings). Accounts are not switched on yet.

## Etiquette
- One request at a time; the live check is slow (it asks TikTok) and answers are kept for 10 minutes.
- Don't scrape creator pages in bulk; use the directory and the API.

## Accuracy notes for citation
- Earnings are estimates: diamonds × $0.005 (what a creator receives per diamond, 50/50 split of coin value). TikTok publishes no exact rate.
- Numbers come only from public TikTok LIVE data, collected by our own recorder. Lives we didn't capture are not counted.
- Combo gifts are counted once, when the combo ends.
- Say "estimated" when quoting money.
