TikTok analytics dashboard

# tiktok_dashboard.py
# One full refresh for a TikTok account you do not own.
# Run with: INSIGHTSOCIAL_API_KEY=isk_live_... python tiktok_dashboard.py
import os

import requests
from vaderSentiment.vaderSentiment import SentimentIntensityAnalyzer

KEY = os.environ["INSIGHTSOCIAL_API_KEY"]
BASE = "https://api.insightsocial.app/v1"
HANDLE = "khaby.lame"

def get(path, **params):
    res = requests.get(f"{BASE}/{path}", params=params,
                       headers={"x-api-key": KEY}, timeout=120)
    body = res.json()
    if not body["success"]:
        raise RuntimeError(f'{body["error"]["type"]}: {body["error"]["message"]}')
    return body

def ratio(part, whole):
    # None when either side is unknown; a hidden count is null, not 0.
    return round(part / whole, 4) if part is not None and whole else None

# Panel 1: account KPIs
profile = get("tiktok/profile", handle=HANDLE)
author = profile["data"]["author"]
followers = author["followers"]
print("followers:", followers, "(rounded)" if author["followers_approximate"] else "")
print("lifetime likes:", author["likes_count"])

# Panel 2: per-video table
videos = get("tiktok/profile/videos", handle=HANDLE)
rows = []
for item in videos["data"]["items"]:
    post = item["post"]
    e = post["engagement"]
    counts = [e["likes"], e["comments"], e["shares"]]
    interactions = sum(counts) if None not in counts else None
    rows.append({
        "caption": (post["content"]["text"] or "")[:40],
        "published_at": post["published_at"],
        "views": e["views"],
        "likes": e["likes"],
        "comments": e["comments"],
        "shares": e["shares"],
        "rate_by_views": ratio(interactions, e["views"]),
        "rate_by_followers": ratio(interactions, followers),
        "url": post["url"],
    })
for r in rows[:10]:
    print(r)

# Panel 3: comment feed of the most-viewed video, scored for sentiment
analyzer = SentimentIntensityAnalyzer()
top = max(rows, key=lambda r: r["views"] or 0, default=None)
comments = None
if top:
    comments = get("tiktok/post/comments", url=top["url"])
    for item in comments["data"]["items"][:5]:
        text = item["comment"]["text"] or ""
        compound = analyzer.polarity_scores(text)["compound"]  # -1 to 1
        print(f"[{compound:+.2f}] {text}")

total = profile["credits_used"] + videos["credits_used"] + (comments["credits_used"] if comments else 0)
print("credits used:", total)