How to Track New Releases from a Record Label

const API_KEY = process.env.SONOVAULT_API_KEY!;
const BASE    = "https://api.sonovault.now/v1";

interface LabelSearchResult {
  id:            number;
  name:          string;
  release_count: number;
}

interface Release {
  id:           number;
  title:        string;
  artist:       { id: number; name: string };
  label:        { id: number; name: string } | null;
  release_date: string | null;
  catalog_no:   string | null;
  track_count:  number;
}

async function api(path: string) {
  const res = await fetch(`${BASE}${path}`, {
    headers: { "x-api-key": API_KEY },
  });
  if (!res.ok) throw new Error(`${res.status} ${res.statusText}`);
  return res.json();
}

// Step 1: Find the label
const { results } = await api("/labels/search?name=Drumcode");
const label = results[0] as LabelSearchResult;
console.log(`Found: ${label.name} (id: ${label.id}, ${label.release_count} releases)`);

// Step 2: Get the paginated release feed
const releasesPage = await api(`/labels/${label.id}/releases?limit=20`);
const releases = releasesPage.results as Release[];

// Step 3: Show recent releases
console.log(`\nLatest releases from ${label.name}:\n`);
releases.forEach((r) => {
  console.log(
    `  ${r.release_date}  ${r.artist.name} — ${r.title} (${r.track_count} tracks)`
  );
});

import fs from "node:fs";

const LABEL_ID    = 482;  // Drumcode
const STATE_FILE  = "./last-seen.json";

// Load previously seen release IDs
const seen: Set<number> = new Set(
  fs.existsSync(STATE_FILE)
    ? JSON.parse(fs.readFileSync(STATE_FILE, "utf-8"))
    : []
);

// Fetch the latest releases on the label
const page = await api(`/labels/${LABEL_ID}/releases?limit=20`);
const releases = page.results as Release[];

// Find new releases since last run
const newReleases = releases.filter(r => !seen.has(r.id));

if (newReleases.length > 0) {
  console.log(`${newReleases.length} new release(s) on Drumcode:\n`);
  newReleases.forEach(r => {
    console.log(`  ${r.artist.name} — ${r.title}`);
  });

  // Send a webhook, email, Slack message, etc.
  // await notify(newReleases);
}

// Save current state
fs.writeFileSync(STATE_FILE, JSON.stringify(releases.map(r => r.id)));