YouTube to MP3 API

// vda-mp3.mjs: create one MP3 job, wait for it, print the final MP3 URL.
// Needs Node.js 22+. Run on your server: node --env-file=.env vda-mp3.mjs
const API = 'https://p.savenow.to';
const POLL_EVERY_MS = 5_000;
const REQUEST_TIMEOUT_MS = 20_000;
const GIVE_UP_AFTER_MS = 10 * 60_000;

const apiKey = (process.env.VDA_API_KEY ?? '').trim();
const sourceUrl = (process.env.VDA_SOURCE_URL ?? '').trim();

async function getJson(path, params) {
  // redirect: 'manual' stops a redirect to a file from being read as progress JSON.
  const response = await fetch(`${API}${path}?${new URLSearchParams(params)}`, {
    redirect: 'manual',
    signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
  });
  if (!response.ok) throw new Error(`${path} returned HTTP ${response.status}.`);
  try {
    return await response.json();
  } catch {
    throw new Error(`${path} did not return JSON.`);
  }
}

async function main() {
  if (!apiKey || apiKey === 'YOUR_API_KEY') throw new Error('Set VDA_API_KEY to your dashboard API key.');
  if (!/^https?:\/\/\S+$/.test(sourceUrl) || sourceUrl.includes('VIDEO_ID')) throw new Error('Set VDA_SOURCE_URL to a real video URL.');

  // The only billable request. The script never sends it again.
  const job = await getJson('/ajax/download.php', {
    format: 'mp3',
    audio_quality: '320', // optional: 128, 192, 256 or 320
    url: sourceUrl,
    apikey: apiKey,
  });
  const id = String(job?.id ?? '').trim();
  if (!job?.success || !id) throw new Error(`MP3 job not created: ${job?.message || job?.text || 'no job id returned'}`);

  const deadline = Date.now() + GIVE_UP_AFTER_MS;
  try {
    while (true) {
      const status = await getJson('/ajax/progress.php', { id });
      const progress = Number(status?.progress);
      if (status?.progress == null || !Number.isFinite(progress)) throw new Error('Progress response has no numeric progress.');

      if (progress >= 1000) {
        const url = typeof status.download_url === 'string' ? status.download_url.trim() : '';
        if ((status.success === 1 || status.success === true) && url) return url;
        throw new Error(`MP3 job failed: ${status.text || status.message || 'no usable download_url'}`);
      }

      if (Date.now() + POLL_EVERY_MS > deadline) {
        throw new Error(`Stopped waiting, the job may still finish. Check later: ${API}/ajax/progress.php?id=${encodeURIComponent(id)}`);
      }
      await new Promise((resolve) => setTimeout(resolve, POLL_EVERY_MS));
    }
  } catch (error) {
    error.message = `${error.message} (job id: ${id})`;
    throw error;
  }
}

try {
  console.log(await main());
} catch (error) {
  console.error(error.message);
  process.exitCode = 1;
}