TikTok Analytics API & Python Guide: Creator Engagement, Video Velocity & Studio Metrics

import time
import statistics
import requests

API_KEY = "tk_live_your_api_key"
BASE_URL = "https://api.shortvidapi.com"
HEADERS = {"x-api-key": API_KEY}

def analyze_creator(username: str) -> dict:
    # 1. Profile stats
    prof = requests.get(f"{BASE_URL}/v1/user/info", params={"unique_id": username}, headers=HEADERS, timeout=20).json()
    stats = prof["data"]["stats"]
    followers = max(1, stats["followerCount"])

    # 2. Latest 35 videos
    posts = requests.get(f"{BASE_URL}/v1/user/posts", params={"unique_id": username, "count": 35}, headers=HEADERS, timeout=25).json()
    videos = [v for v in posts["data"].get("videos", []) if not v.get("is_top")]

    now = time.time()
    erv_list, save_rate_list, views_list, vph_list = [], [], [], []
    for v in videos:
        views = max(1, v.get("play_count", 0))
        interactions = (
            v.get("digg_count", 0)
            + v.get("comment_count", 0)
            + v.get("share_count", 0)
            + v.get("collect_count", 0)
        )
        age_hours = max(1.0, (now - v.get("create_time", now)) / 3600.0)
        views_list.append(views)
        erv_list.append(interactions / views)
        save_rate_list.append(v.get("collect_count", 0) / views)
        vph_list.append(views / age_hours)

    return {
        "username": username,
        "followers": followers,
        "videos_analyzed": len(videos),
        "median_views": int(statistics.median(views_list)) if views_list else 0,
        "views_to_followers_pct": round((statistics.median(views_list) / followers) * 100, 2) if views_list else 0,
        "avg_engagement_rate_pct": round(statistics.mean(erv_list) * 100, 2) if erv_list else 0,
        "avg_save_rate_pct": round(statistics.mean(save_rate_list) * 100, 2) if save_rate_list else 0,
        "top_views_per_hour": round(max(vph_list), 1) if vph_list else 0,
    }

if __name__ == "__main__":
    print(analyze_creator("tiktok"))