Creator engagement scoring
Compare a creator's engagement rate across TikTok, Instagram, and YouTube on one ranked table — same formula, same clamp, 3 credits per creator.
Creator engagement scoring
Build a creator-vetting tool for an influencer-marketing team that needs to compare a creator's TikTok performance against their Instagram and YouTube on a single ranked dashboard.
How do you compare engagement rates across platforms?
Fetch the creator's profile from each platform's profile endpoint — /v1/tiktok/profile, /v1/instagram/profile, /v1/youtube/channel — and read computed.engagement_rate from each response. SocialCrawl computes every platform's rate with the same formula and clamps it into [0, 1], so the numbers are directly comparable across platforms.
The problem
Raw engagement numbers don't compare across platforms. A TikTok like is not an Instagram like is not a YouTube comment; follower counts inflate differently; and every analytics vendor defines "engagement rate" its own way. Vetting a creator means re-deriving the metric per platform — or trusting three incompatible dashboards.
The solution
Three standard-tier profile endpoints (1 credit each), each carrying the same computed field:
GET /v1/tiktok/profile— TikTok profile withcomputed.engagement_rateGET /v1/instagram/profile— Instagram profile withcomputed.engagement_rateGET /v1/youtube/channel— YouTube channel withcomputed.engagement_rate
This recipe shows the payoff for SocialCrawl's canonical schema: every platform's engagement_rate is computed against the same formula and clamped into [0, 1], so a TikTok 0.082 is directly comparable to an Instagram 0.082.
// recipe-engagement-table.ts
// Compares one creator's engagement across TikTok, Instagram, and YouTube.
// Run with: SOCIALCRAWL_KEY=sc_... npx tsx recipe-engagement-table.ts
const KEY = process.env.SOCIALCRAWL_KEY;
if (!KEY) throw new Error("Set SOCIALCRAWL_KEY");
const BASE = "https://www.socialcrawl.dev/v1";
const handle = "mrbeast";
type Profile = {
success: boolean;
platform: string;
data?: {
author: { username: string | null; followers: number | null };
computed: {
engagement_rate: number | null;
estimated_reach: number | null;
language: string | null;
content_category: string | null;
};
};
};
async function get(
path: string,
params: Record<string, string>,
): Promise<Profile> {
const url = new URL(`${BASE}/${path}`);
for (const [k, v] of Object.entries(params)) url.searchParams.set(k, v);
const res = await fetch(url, { headers: { "x-api-key": KEY! } });
return (await res.json()) as Profile;
}
const [tiktok, instagram, youtube] = await Promise.all([
get("tiktok/profile", { handle }),
get("instagram/profile", { handle }),
get("youtube/channel", { handle }),
]);
const rows = [tiktok, instagram, youtube]
.filter((p) => p.success && p.data)
.map((p) => ({
platform: p.platform,
followers: p.data!.author.followers,
engagement_rate: p.data!.computed.engagement_rate,
estimated_reach: p.data!.computed.estimated_reach,
}))
.sort((a, b) => (b.engagement_rate ?? 0) - (a.engagement_rate ?? 0));
console.table(rows);What you get back
// console.table output:
// ┌─────────┬───────────┬───────────┬─────────────────┬──────────────────┐
// │ (index) │ platform │ followers │ engagement_rate │ estimated_reach │
// ├─────────┼───────────┼───────────┼─────────────────┼──────────────────┤
// │ 0 │ "tiktok" │ 95000000 │ 1 │ 9500000 │ // <-- clamped, see warnings
// │ 1 │ "youtube" │ 351000000 │ 0.0842 │ 2957420 │
// │ 2 │ "instagram"│ 64200000 │ 0.0413 │ 265146 │
// └─────────┴───────────┴───────────┴─────────────────┴──────────────────┘Credits cost
Cost per run: 3 credits per creator (3 platforms × 1 credit). Vetting a 100-creator shortlist costs 300 credits.
Take it further
- See Computed fields for the per-platform engagement formulas and what triggers the
[0, 1]clamp warning visible on TikTok above. - Swap
mrbeastfor any handle on those three platforms —charlidamelio,khaby.lame,mkbhd. - Next: Music trend detection applies the same parallel-fetch + composite-score pattern to music.
- Going deeper on one platform? See TikTok analytics dashboard. Platform references: TikTok API, Instagram API, YouTube API.
