# TKCount — Real-Time TikTok Counter & Analytics Monitor

TKCount is a premium analytics platform built to track TikTok growth metrics in real-time. It bypasses rounded application figures and caches to deliver precise telemetry directly from public data distribution nodes.

## Core Features
- **Real-Time Follower Checker**: Track changes in subscriber/follower counts by the second.
- **Live Video View Tracker**: Observe precise view increments, likes, comments, and shares side-by-side.
- **Monospace retro terminal UI**: Implements glassmorphism styled metrics cards and clean Odometer.js ticking animations.
- **Multiple Languages**: Supports localized platforms for `es`, `de`, `fr`, `id`, and `ar`.

## Pages Index
- **Home (Follower Counter)**: `/`
  - Purpose: Core landing page allowing creators to search user handles and stream real-time follower shifts.
- **Live View Counter (Legacy)**: `/tiktok-live-view-counter/`
  - Purpose: Real-time telemetry monitoring for video metrics.
- **Video Live Counter (Primary)**: `/tiktok-video-live-counter/`
  - Purpose: Standard views and stream analytics monitor.

## Localized Paths
TKCount is fully accessible in the following localized routes:
- **Spanish (`es`)**: `/es/`, `/es/tiktok-live-view-counter/`, `/es/tiktok-video-live-counter/`
- **German (`de`)**: `/de/`, `/de/tiktok-live-view-counter/`, `/de/tiktok-video-live-counter/`
- **French (`fr`)**: `/fr/`, `/fr/tiktok-live-view-counter/`, `/fr/tiktok-video-live-counter/`
- **Indonesian (`id`)**: `/id/`, `/id/tiktok-live-view-counter/`, `/id/tiktok-video-live-counter/`
- **Arabic (`ar`)**: `/ar/`, `/ar/tiktok-live-view-counter/`, `/ar/tiktok-video-live-counter/`

## API Reference
The platform exposes several secure internal API routes. Direct HTTP clients must include `X-Requested-With: exporttik-client` and a valid `X-CSRF-Token` header mapped to the active session.

### 1. User Live Metrics
- **Endpoint**: `GET /api/user/:username?live=true`
- **Response Shape**:
  ```json
  {
    "success": true,
    "data": {
      "id": "1234567890",
      "username": "mrbeast",
      "nickname": "MrBeast",
      "avatar": "https://...",
      "stats": {
        "followerCount": 150000000,
        "followingCount": 320,
        "heartCount": 4200000000,
        "videoCount": 780
      }
    }
  }
  ```

### 2. Video Live Metrics
- **Endpoint**: `POST /api/video/info`
- **Payload**: `{ "url": "https://www.tiktok.com/@user/video/12345", "live": true }`
- **Response Shape**:
  ```json
  {
    "success": true,
    "data": {
      "videoId": "12345",
      "author": { "username": "user", "nickname": "User", "avatar": "https://..." },
      "stats": {
        "playCount": 1200500,
        "diggCount": 45000,
        "commentCount": 3500,
        "shareCount": 980
      }
    }
  }
  ```

For full setup documentation, refer to the full specifications in [llms-full.txt](/llms-full.txt).