Instagram Video Downloader API

curl -X POST https://developers.getinsaver.com/v1/resolve \
  -H "Authorization: Bearer $GIS_KEY" \
  -H "Content-Type: application/json" \
  --max-time 130 \
  -d '{"service": "instagram", "url": "https://www.instagram.com/reel/SHORTCODE/", "max_results": 10}'

{
    "ok": true,
    "service": "instagram",
    "source_url": "https://www.instagram.com/reel/SHORTCODE/",
    "item_count": 1,
    "items": [
        {
            "type": "video",
            "url": "https://cdn.example/media.mp4"
        }
    ],
    "metadata": {
        "title": null,
        "author": "creator",
        "caption": null
    },
    "request_id": "39a3bff5-0000-4000-8000-000000000000",
    "credits_used": 1
}

// Node.js 18+ (built-in fetch, no packages). Run: GIS_KEY=gis_live_... node resolve.mjs
import { createWriteStream } from "node:fs";
import { mkdir } from "node:fs/promises";
import { Readable } from "node:stream";
import { pipeline } from "node:stream/promises";

const API_URL = "https://developers.getinsaver.com/v1/resolve";
const EXT = { "video/mp4": ".mp4", "image/jpeg": ".jpg", "image/png": ".png", "image/webp": ".webp", "audio/mpeg": ".mp3" };
const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

async function resolveLink(service, url, maxResults = 10, retries = 3) {
  for (let attempt = 0; ; attempt++) {
    const response = await fetch(API_URL, {
      method: "POST",
      headers: { Authorization: `Bearer ${process.env.GIS_KEY}`, "Content-Type": "application/json" },
      body: JSON.stringify({ service, url, max_results: maxResults }),
      signal: AbortSignal.timeout(130_000)
    });
    const data = await response.json();
    if (response.ok) return data;
    // 429 = rate or concurrency limit, 502/504 = platform hiccup; none of them is charged
    if ([429, 502, 504].includes(response.status) && attempt < retries) {
      await sleep(Number(response.headers.get("retry-after") || 5) * 1000);
      continue;
    }
    throw new Error(`${data.code}: ${data.message}`);
  }
}

// Media URLs expire within minutes to hours, so save the file right away.
async function download(item, name, folder = "downloads") {
  const media = await fetch(item.url, { signal: AbortSignal.timeout(120_000) });
  if (!media.ok) throw new Error(`download failed: HTTP ${media.status}`);
  await mkdir(folder, { recursive: true });
  const type = (media.headers.get("content-type") || "").split(";")[0];
  const path = `${folder}/${name}${EXT[type] || ".bin"}`;
  await pipeline(Readable.fromWeb(media.body), createWriteStream(path));
  return path;
}

const result = await resolveLink("instagram", "https://www.instagram.com/reel/SHORTCODE/");
console.log(`${result.item_count} items, ${result.credits_used} credits`);
for (const [i, item] of result.items.entries()) {
  console.log(item.type, await download(item, `${result.request_id}-${i}`));
}