Music trend detection

// recipe-music-heat.ts
// Calculates a cross-platform "heat score" for one track.
// Run with: SOCIALCRAWL_KEY=sc_... npx tsx recipe-music-heat.ts

const KEY = process.env.SOCIALCRAWL_KEY;
if (!KEY) throw new Error("Set SOCIALCRAWL_KEY");

const BASE = "https://www.socialcrawl.dev/v1";

// Both ids are stable per track, resolve them once and store them.
const tiktokClipId = "7349589214432069122";
const instagramAudioId = "1392969992841787";
const spotifyQuery = "Espresso Sabrina Carpenter";

async function get(path: string, params: Record<string, string>) {
  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 {
    success: boolean;
    data?: Record<string, unknown>;
  };
}

const [tiktok, instagram, spotify] = await Promise.all([
  get("tiktok/song/videos", { clipId: tiktokClipId }),
  get("instagram/audio/reels", { audio_id: instagramAudioId }),
  get("spotify/search", { query: spotifyQuery }),
]);

type PostItem = { post?: { engagement?: { views?: number | null } } };

// TikTok reports a total usage count for the sound.
const tiktokVideos = (tiktok.data?.total as number | undefined) ?? 0;

// Instagram returns ONE PAGE of reels, there is no total. Summing views on
// the first page is a reach sample, not a catalogue count. Page with `cursor`
// if you want more depth; the weight below assumes one page.
const instagramReelViews = (
  (instagram.data?.items as PostItem[] | undefined) ?? []
).reduce((sum, item) => sum + (item.post?.engagement?.views ?? 0), 0);

const spotifyPlays =
  (spotify.data?.items as PostItem[] | undefined)?.[0]?.post?.engagement
    ?.views ?? 0;

// Weighted composite. Tune the weights for your use case.
const heat =
  Math.log10(tiktokVideos + 1) * 0.5 +
  Math.log10(instagramReelViews + 1) * 0.2 +
  Math.log10(spotifyPlays + 1) * 0.3;

console.log({
  tiktok_videos: tiktokVideos,
  instagram_reel_views: instagramReelViews,
  spotify_plays: spotifyPlays,
  heat_score: heat.toFixed(2),
});

// Aggregated, post-composite:
{
  "tiktok_videos": 2400000, // <-- `data.total` from TikTok song/videos
  "instagram_reel_views": 41800000, // <-- summed over ONE page of audio/reels
  "spotify_plays": 1180000000, // <-- top track from Spotify search
  "heat_score": "7.44", // <-- log-weighted composite of the three above
}