Research & Analytics

const API = "https://videodownloadapi.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.VIDEO_API_KEY}`,
  "Content-Type": "application/json",
};

type Download = { download_id: string; status: string; title: string; download_url?: string };

async function download(url: string, options: { format?: string; quality?: string } = {}) {
  const res = await fetch(`${API}/downloads`, {
    method: "POST",
    headers,
    body: JSON.stringify({ url, ...options }),
  });
  if (res.status === 402) throw new Error("Not enough minutes");
  if (res.status === 429) throw new Error("Too many requests: retry in a few seconds");
  let item: Download = await res.json();

  // Poll until the file is ready (or failed: minutes are refunded automatically)
  while (item.status !== "ready" && item.status !== "failed") {
    await new Promise((resolve) => setTimeout(resolve, 3000));
    item = await fetch(`${API}/downloads/${item.download_id}`, { headers }).then((r) => r.json());
  }
  if (item.status === "failed") throw new Error(`Download failed: ${url}`);
  return item;
}

// Collect a batch of videos for analysis, one job after another
async function batchDownloadForResearch(urls: string[]) {
  for (const url of urls) {
    try {
      const item = await download(url, { quality: "720p" }); // balanced for storage
      console.log(`✓ ${item.title}`);
    } catch (error) {
      console.error(`✗ ${url}: ${error}`);
    }
  }
}

batchDownloadForResearch([
  "https://youtube.com/watch?v=VIDEO_1",
  "https://tiktok.com/@user/video/123",
]);