TikTok Creator Audit Before Brand Deals: API Approach

import requests

def audit_creator(username: str) -> dict:
    """Comprehensive creator audit before brand deal."""
    # Get creator profile
    profile_resp = requests.post(
        "https://api.scavio.dev/api/v1/tiktok/user/info",
        headers={"Authorization": "Bearer YOUR_KEY"},
        json={"username": username}
    )
    profile = profile_resp.json().get("data", {}).get("user", {})

    followers = profile.get("stats", {}).get("followerCount", 0)
    following = profile.get("stats", {}).get("followingCount", 0)
    total_likes = profile.get("stats", {}).get("heartCount", 0)

    # Get recent posts for engagement analysis
    posts_resp = requests.post(
        "https://api.scavio.dev/api/v1/tiktok/user/posts",
        headers={"Authorization": "Bearer YOUR_KEY"},
        json={"username": username, "count": 20}
    )
    posts = posts_resp.json().get("data", {}).get("videos", [])

    # Calculate engagement metrics
    engagement_rates = []
    for post in posts:
        stats = post.get("stats", {})
        views = stats.get("playCount", 0)
        if views > 0:
            engagement = (
                stats.get("diggCount", 0) +
                stats.get("commentCount", 0) +
                stats.get("shareCount", 0)
            ) / views * 100
            engagement_rates.append(engagement)

    avg_engagement = sum(engagement_rates) / len(engagement_rates) if engagement_rates else 0
    engagement_std = (
        sum((x - avg_engagement) ** 2 for x in engagement_rates) / len(engagement_rates)
    ) ** 0.5 if len(engagement_rates) > 1 else 0

    return {
        "username": username,
        "followers": followers,
        "following": following,
        "total_likes": total_likes,
        "avg_engagement_rate": round(avg_engagement, 2),
        "engagement_consistency": round(engagement_std, 2),
        "posts_analyzed": len(posts),
        "red_flags": _check_red_flags(followers, following, avg_engagement, engagement_std)
    }

def _check_red_flags(followers, following, avg_eng, eng_std):
    flags = []
    if followers > 10000 and avg_eng < 1.0:
        flags.append("Low engagement for follower count (possible fake followers)")
    if following > followers * 0.8:
        flags.append("Following ratio too high (follow-for-follow pattern)")
    if eng_std > avg_eng * 2:
        flags.append("Engagement wildly inconsistent (possible manipulation)")
    return flags

audit = audit_creator("creator_username")
print(f"Avg engagement: {audit['avg_engagement_rate']}%")
print(f"Red flags: {audit['red_flags']}")

// Compare multiple creators for a campaign
async function batchAudit(usernames) {
  const results = [];

  for (const username of usernames) {
    const profileResp = await fetch(
      "https://api.scavio.dev/api/v1/tiktok/user/info",
      {
        method: "POST",
        headers: {
          "Authorization": "Bearer " + process.env.SCAVIO_KEY,
          "Content-Type": "application/json"
        },
        body: JSON.stringify({ username })
      }
    );

    const profile = await profileResp.json();
    const stats = profile.data?.user?.stats || {};

    results.push({
      username,
      followers: stats.followerCount || 0,
      totalLikes: stats.heartCount || 0,
      likesToFollowerRatio: stats.followerCount > 0
        ? (stats.heartCount / stats.followerCount).toFixed(1)
        : 0
    });
  }

  // Sort by likes-to-follower ratio (higher = more authentic engagement)
  return results.sort((a, b) => b.likesToFollowerRatio - a.likesToFollowerRatio);
}