> ## BetterTok Full Documentation
> This file contains complete documentation for AI agents.
> For a quick overview, see: https://bettertok.app/llms.txt
> Request any page with Accept: text/markdown for clean content.

# BetterTok - Complete Documentation

## Table of Contents

1. [Platform Overview](#platform-overview)
2. [Discord Bot](#discord-bot)
3. [TikTok Gift Database](#tiktok-gift-database)
4. [Gift Calculator](#gift-calculator)
5. [Stream Overlays](#stream-overlays)
6. [Chrome Extension](#chrome-extension)
7. [Pricing](#pricing)
8. [TikTok Economics](#tiktok-economics)
9. [API & Integration](#api--integration)
10. [FAQs](#faqs)
11. [Site Map](#site-map)

---

## Platform Overview

BetterTok is the #1 TikTok Live integration platform, connecting TikTok streams to Discord communities. The platform provides:

- **Discord Bot**: Automated live notifications, roles, XP, and leaderboards
- **Gift Database**: 1,400+ TikTok gifts with real-time pricing
- **Gift Calculator**: Convert coins to USD with creator earnings
- **Stream Overlays**: Professional OBS widgets for live streams
- **Chrome Extension**: Enhanced TikTok viewing experience

### Key Statistics
- 10,000+ creators using BetterTok
- 1,400+ TikTok gifts catalogued
- Prices updated every 5 minutes
- 20+ regional markets supported

### Target Audience
- TikTok Live streamers
- Discord community managers
- Content creators
- Gaming streamers
- Music performers

---

## Discord Bot

**URL**: https://bettertok.app/discord-bot

The BetterTok Discord bot automates TikTok Live integration with Discord servers.

### Features

#### Live Role Assignment
- Automatically assigns "Live" role when creator goes live on TikTok
- Removes role when stream ends
- Supports custom role configuration
- Works with multiple TikTok accounts per server

#### Live Notifications
- Posts notification when creator goes live
- Includes stream preview image
- Shows viewer count and stream title
- Configurable notification channels
- Custom message templates

#### Gift Tracking
- Real-time tracking of all gifts received
- USD value calculations
- Leaderboards showing top gifters
- Session and all-time statistics
- Export gift history

#### XP & Leveling System
- Awards XP for stream engagement
- Customizable XP rates
- Level-up notifications
- Role rewards for levels
- Leaderboard rankings

#### Commands
- `/live` - Check if TikTok user is currently live
- `/gifts` - View gift leaderboard
- `/xp` - Check user XP and level
- `/download` - Download TikTok video
- `/stats` - View stream statistics

### Setup Instructions

1. **Add Bot to Server**
   - Visit: https://discord.com/oauth2/authorize?client_id=1435083909879562431&permissions=8&integration_type=0&scope=bot
   - Select your Discord server
   - Grant required permissions

2. **Connect TikTok Account**
   - Go to https://bettertok.app/dashboard
   - Sign in with Discord
   - Enter your TikTok username
   - No TikTok password required

3. **Configure Notifications**
   - Select notification channel
   - Customize message template
   - Set live role

4. **Test Setup**
   - Go live on TikTok
   - Bot will post notification
   - Live role will be assigned

---

## TikTok Gift Database

**URL**: https://bettertok.app/tools/tiktok-gifts

The most comprehensive TikTok gift database with 1,400+ gifts.

### Features

- Complete catalogue of all TikTok LIVE gifts
- HD images for each gift
- Real-time prices from TikTok API
- USD value calculations
- Creator earnings (after 50% platform fee)
- Regional availability data
- Search and filter functionality

### Gift Categories

#### Basic Gifts (1-99 coins)
Entry-level gifts for casual appreciation:
- Rose (1 coin) - $0.01
- TikTok (1 coin) - $0.01
- Heart (5 coins) - $0.05
- Drama Queen (5 coins) - $0.05
- Finger Heart (5 coins) - $0.05
- Thumbs Up (5 coins) - $0.05

#### Premium Gifts (100-999 coins)
Mid-range gifts showing stronger support:
- Perfume (100 coins) - $1.05
- Doughnut (100 coins) - $1.05
- Sign language love (100 coins) - $1.05
- Hand Hearts (100 coins) - $1.05
- Concert (500 coins) - $5.25
- I'm Very Rich (500 coins) - $5.25

#### Luxury Gifts (1,000-4,999 coins)
Premium gifts for special moments:
- Galaxy (1,000 coins) - $10.50
- Interstellar (1,088 coins) - $11.42
- Diamond (1,000 coins) - $10.50
- Chasing the Dream (2,000 coins) - $21.00
- Stars (3,000 coins) - $31.50

#### Mega Gifts (5,000+ coins)
VIP-level gifts with spectacular animations:
- Lion (29,999 coins) - $314.99
- TikTok Universe (44,999 coins) - $472.49
- Falcon (25,000 coins) - $262.50
- Planet (15,000 coins) - $157.50
- Castle (10,000 coins) - $105.00

### Price Pages

- All Gifts: https://bettertok.app/tools/tiktok-gifts
- Basic Tier: https://bettertok.app/tools/tiktok-gifts/category/basic
- Premium Tier: https://bettertok.app/tools/tiktok-gifts/category/premium
- Luxury Tier: https://bettertok.app/tools/tiktok-gifts/category/luxury
- Mega Tier: https://bettertok.app/tools/tiktok-gifts/category/mega
- Top 50 Most Expensive: https://bettertok.app/tools/tiktok-gifts/popular

### Regional Availability

TikTok gifts vary by region. Available regions include:
- United States
- United Kingdom
- Canada
- Australia
- Germany
- France
- Japan
- Brazil
- And 15+ more countries

Regional pages: https://bettertok.app/tools/tiktok-gifts/regions

---

## Gift Calculator

**URL**: https://bettertok.app/tools/gift-calculator

Calculate the exact value of TikTok gifts and creator earnings.

### Features

- **Coin to USD Conversion**: Instant calculation
- **Creator Earnings**: Shows earnings after 50% platform fee
- **Multiple Gifts**: Add multiple gifts with quantities
- **Export**: Download calculations for accounting
- **Real-time Rates**: Uses current exchange rates

### How It Works

1. **TikTok Coin Exchange**
   - Users buy coins with real money
   - 1 coin ≈ $0.0105 USD (varies slightly by region)
   - Coins are used to purchase gifts

2. **Gift Values**
   - Each gift costs a specific number of coins
   - Gift value = coins × exchange rate

3. **Creator Earnings**
   - TikTok takes approximately 50% platform fee
   - Creator receives approximately 50% of gift value
   - Actual percentage may vary by region and agreement

### Example Calculation

| Gift | Coins | USD Value | Creator Earns |
|------|-------|-----------|---------------|
| 5× Rose | 5 | $0.05 | $0.025 |
| 2× Galaxy | 2,000 | $21.00 | $10.50 |
| 1× Lion | 29,999 | $314.99 | $157.50 |
| **Total** | **32,004** | **$336.04** | **$168.02** |

---

## Stream Overlays

**URL**: https://bettertok.app/overlays

Professional OBS-ready widgets for TikTok Live streams.

### Available Widgets

#### Gift Goal
- Progress bar toward gift goals
- Customizable target amounts
- Animated progress updates
- Multiple goal tiers

#### Leaderboard
- Real-time top gifters display
- Session or all-time rankings
- Customizable display count
- Avatar and username display

#### Recent Gifts
- Live feed of incoming gifts
- Gift animations
- Sender username display
- Gift value display

#### Chat Overlay
- TikTok chat display in OBS
- Customizable styling
- Emote support
- Moderation filtering

#### Timer/Countdown
- Custom timers for events
- Countdown to goals
- Stream duration display

### Customization Options

All overlays support:
- Custom colors and themes
- Font selection
- Size adjustment
- Animation styles
- Transparency settings
- Position configuration

### Setup

1. Go to https://bettertok.app/dashboard
2. Navigate to Overlays section
3. Configure widget settings
4. Copy overlay URL
5. Add as Browser Source in OBS
6. Set dimensions (typically 400×600 for vertical, 800×200 for horizontal)

---

## Chrome Extension

**URL**: https://bettertok.app/extension

Enhanced TikTok Live viewing experience.

### Features

#### Custom Emotes
- 7TV emote support
- BTTV (BetterTTV) emotes
- FFZ (FrankerFaceZ) emotes
- Animated emotes
- Emote autocomplete

#### Theater Mode
- Distraction-free viewing
- Hides sidebar and navigation
- Fullscreen-like experience
- Keyboard toggle (T key)

#### Picture-in-Picture
- Watch while browsing
- Resizable PiP window
- Always-on-top option
- Multi-monitor support

#### Quick Tools
- Fast access to BetterTok dashboard
- Gift calculator shortcut
- Stream statistics overlay

### Installation

1. Visit Chrome Web Store (link on extension page)
2. Click "Add to Chrome"
3. Pin extension to toolbar
4. Configure settings

---

## Pricing

**URL**: https://bettertok.app/pricing

### Free Plan - $0/month

Perfect for getting started:
- 1 Discord server
- 2 alert channels
- Live role assignment
- /download command
- Full gift database access
- Gift calculator access
- Basic stream overlays

### Creator Plan - $9.99/month

For serious creators:
- 5 Discord servers
- 100 alert channels
- Full dashboard access
- Advanced analytics
- Text-to-Speech (TTS)
- Premium overlays
- Points/rewards system
- Priority support
- Custom branding (coming soon)

### Enterprise

Contact for custom pricing:
- Unlimited servers
- API access
- White-label options
- Dedicated support
- Custom integrations

---

## TikTok Economics

### Coin Purchase Rates

Users buy coins at these approximate rates (USD):
- 65 coins: $0.99
- 330 coins: $4.99
- 660 coins: $9.99
- 1,321 coins: $19.99
- 3,303 coins: $49.99
- 6,607 coins: $99.99
- 16,500 coins: $249.99

### Exchange Rate
- 1 TikTok coin ≈ $0.0105 USD
- Rate varies slightly by region and purchase amount

### Creator Revenue Share
- TikTok retains approximately 50% of gift value
- Creators receive approximately 50%
- Actual percentages may vary by:
  - Region
  - Creator agreement
  - Total earnings
  - Account standing

### Withdrawal
- Minimum withdrawal threshold varies by region
- Processing time: 15-21 business days
- Payment methods vary by region

---

## API & Integration

### Content Negotiation

BetterTok supports content negotiation for AI agents:

**Request Markdown Content:**
```bash
curl -H "Accept: text/markdown" https://bettertok.app/
```

**Response:**
- Clean Markdown without HTML markup
- Structured content for easy parsing
- Documentation index reference at top

### Discovery Headers

All BetterTok responses include:
```
Link: </llms.txt>; rel="llms-txt", </llms-full.txt>; rel="llms-full-txt"
X-Llms-Txt: /llms.txt
```

### Robots.txt

AI crawlers are explicitly allowed:
- GPTBot (OpenAI)
- ChatGPT-User
- ClaudeBot (Anthropic)
- Google-Extended (Gemini)
- PerplexityBot
- Bingbot
- And 20+ more

See: https://bettertok.app/robots.txt

---

## FAQs

### General

**Q: Is BetterTok free?**
A: Yes! BetterTok offers a generous free tier with 1 Discord server, full tool access, and basic features.

**Q: How do I get started?**
A: Add the bot to Discord, sign in at bettertok.app, enter your TikTok username, and configure notifications.

**Q: Does BetterTok require my TikTok password?**
A: No. BetterTok only needs your public TikTok username to detect when you go live.

### Technical

**Q: How often are gift prices updated?**
A: Every 5 minutes directly from TikTok's API.

**Q: How accurate is the gift calculator?**
A: Very accurate. We use real-time exchange rates and official TikTok gift prices.

**Q: Can I use overlays without the Discord bot?**
A: Yes! Overlays work independently.

### Privacy

**Q: What data does BetterTok store?**
A: Only Discord user IDs, TikTok usernames, and gift/XP statistics.

**Q: Is my data shared?**
A: No. We never sell or share user data with third parties.

---

## Site Map

### Main Pages
- https://bettertok.app - Homepage
- https://bettertok.app/discord-bot - Discord Bot
- https://bettertok.app/extension - Chrome Extension
- https://bettertok.app/overlays - Stream Overlays
- https://bettertok.app/pricing - Pricing

### Tools
- https://bettertok.app/tools - All Tools
- https://bettertok.app/tools/tiktok-gifts - Gift Database
- https://bettertok.app/tools/gift-calculator - Calculator
- https://bettertok.app/tools/sticker-maker - Sticker Maker

### Gift Categories
- https://bettertok.app/tools/tiktok-gifts/category/basic
- https://bettertok.app/tools/tiktok-gifts/category/premium
- https://bettertok.app/tools/tiktok-gifts/category/luxury
- https://bettertok.app/tools/tiktok-gifts/category/mega

### Resources
- https://bettertok.app/tools/tiktok-gifts/earnings-guide
- https://bettertok.app/tools/tiktok-gifts/sending-guide
- https://bettertok.app/tools/tiktok-gifts/best-value
- https://bettertok.app/tools/tiktok-gifts/tier-list
- https://bettertok.app/tools/tiktok-gifts/regions
- https://bettertok.app/tools/tiktok-gifts/popular

### Legal
- https://bettertok.app/privacy - Privacy Policy
- https://bettertok.app/terms - Terms of Service

### Blog
- https://bettertok.app/blog - All Posts
- RSS Feed: https://bettertok.app/blog/feed.xml

### Community
- Discord: https://discord.gg/KM9aZ4Uj9a
- Add Bot: https://discord.com/oauth2/authorize?client_id=1435083909879562431&permissions=8&integration_type=0&scope=bot

---

## Technical Specifications

### Supported Platforms
- Discord (all platforms)
- Chrome/Chromium browsers
- OBS Studio
- StreamLabs
- TikTok Live Studio

### API Rate Limits
- Gift database: No rate limiting for public access
- Dashboard API: 100 requests/minute per user

### Data Retention
- Gift statistics: Indefinite
- Stream history: 90 days
- XP data: Indefinite

---

Last updated: February 2026
Version: 2.0