REST API for automating TikTok streak messages. Control your TikTok Streak Bot via API endpoints.

• FastAPI: Modern, fast (high-performance) web framework
• Secure: All configurations via environment variables - no hardcoded secrets
• API Key Auth: Protected endpoints with X-API-Key header
• Telegram Notifications: Get notified when streaks are sent
• Auto Documentation: Swagger UI and ReDoc included

git clone https://github.com/dewhush/TikTok-Streak-API.git
cd TikTok-Streak-API

pip install -r requirements.txt

Copy the example environment file:

# Linux/Mac
cp .env.example .env

# Windows
copy .env.example .env

Edit .env and fill in your values:

# Required
API_KEY=your-secure-api-key-here
TELEGRAM_BOT_TOKEN=your-telegram-bot-token
TELEGRAM_CHAT_ID=your-telegram-chat-id

1. Login to TikTok in your browser
2. Export cookies as cookies.json in the project root
3. The bot will use these cookies to authenticate

Create contacts.json:

{
    "contacts": ["username1", "username2"]
}

Windows (Batch Script):

run_api.bat

Manual:

uvicorn api:app --host 0.0.0.0 --port 8000 --reload

Python:

python api.py

Once running, access:

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

Protected endpoints require X-API-Key header:

curl -X GET "http://localhost:8000/v1/contacts" \
  -H "X-API-Key: your-api-key-here"

Run Streak Bot:

curl -X POST "http://localhost:8000/v1/streak" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"message": "Hey! Streak time 🔥"}'

Response:

{
  "success": true,
  "message": "Streak bot started in background",
  "data": {
    "custom_message": "Hey! Streak time 🔥",
    "started_at": "2026-01-17T01:30:00.000000"
  }
}

Add Contact:

curl -X POST "http://localhost:8000/v1/contacts" \
  -H "X-API-Key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"nickname": "friend_username"}'

List Contacts:

curl -X GET "http://localhost:8000/v1/contacts" \
  -H "X-API-Key: your-api-key-here"

Remove Contact:

curl -X DELETE "http://localhost:8000/v1/contacts/friend_username" \
  -H "X-API-Key: your-api-key-here"

TikTok-Streak-API/
├── api.py              # FastAPI app & routes
├── config.py           # Configuration (loads from .env)
├── streak_bot.py       # Main bot logic
├── requirements.txt    # Python dependencies
├── .env.example        # Environment template
├── .gitignore          # Git exclusions
├── run_api.bat         # Windows startup script
└── README.md           # This file

• Never commit .env - Contains your secrets
• Never commit cookies.json - Contains session data
• Never commit contacts.json - Contains user data
• Use strong API keys - Generate random secure keys
• Rotate Telegram tokens - If exposed, regenerate via @BotFather

MIT License - See LICENSE file for details.

Created by dewhush