Batch Screenshot API

curl -X POST "https://captureapi.dev/api/v1/batch" \
  -H "X-API-Key: cap_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      { "url": "https://example.com", "fullPage": true },
      { "url": "https://example.org", "width": 1920, "height": 1080 },
      { "url": "https://example.net", "format": "jpeg" }
    ]
  }'

{
  "success": true,
  "batch_id": "batch_m3k2j1_a8f2",
  "total": 3,
  "succeeded": 2,
  "failed": 1,
  "truncated": false,
  "not_processed": [],
  "duration_ms": 12480,
  "results": [
    {
      "request_id": "req_m3k2j1_b4c1",
      "url": "https://example.com",
      "status": "completed",
      "format": "png",
      "width": 1280,
      "height": 720,
      "file_size": 184320,
      "duration_ms": 4210,
      "image": "data:image/png;base64,iVBORw0KGgo...",
      "truncated": false,
      "page_height": 4180,
      "degraded": false,
      "images_pending": 0
    },
    {
      "request_id": "req_m3k2j1_b4c2",
      "url": "https://blocks-robots.example",
      "status": "failed",
      "error_code": "TARGET_RENDERED_NOTHING",
      "error_message": "The target page loaded but rendered no visible content...",
      "duration_ms": 3120
    }
  ],
  "meta": { "plan": "pro", "remaining": 14997 }
}

let pending = urls;

while (pending.length > 0) {
  const res = await fetch("https://captureapi.dev/api/v1/batch", {
    method: "POST",
    headers: {
      "X-API-Key": process.env.CAPTURE_API_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ urls: pending.slice(0, 10).map((url) => ({ url })) }),
  });

  const body = await res.json();
  save(body.results);

  // Anything the time budget could not reach comes back here — and was not
  // charged. Put it at the front of the next request.
  pending = [...body.not_processed, ...pending.slice(10)];
}

import fs from "node:fs/promises";

const API_KEY = process.env.CAPTURE_API_KEY;
const CONCURRENCY = 3; // stay under your plan's per-second burst limit

const urls = [
  "https://example.com",
  "https://example.org",
  // ...as many as you like
];

async function capture(url) {
  const params = new URLSearchParams({
    url,
    width: "1440",
    full_page: "true",
    block_cookie_banners: "true",
    format: "png",
  });

  const res = await fetch(`https://captureapi.dev/api/v1/screenshot?${params}`, {
    headers: { "X-API-Key": API_KEY },
  });

  if (!res.ok) {
    const err = await res.json().catch(() => null);
    throw new Error(err?.error?.message ?? `HTTP ${res.status}`);
  }

  const name = new URL(url).hostname.replace(/\W+/g, "-") + ".png";
  await fs.writeFile(name, Buffer.from(await res.arrayBuffer()));
  return name;
}

// Simple concurrency-limited queue.
const queue = [...urls];
await Promise.all(
  Array.from({ length: CONCURRENCY }, async () => {
    let url;
    while ((url = queue.shift())) {
      try {
        console.log("saved", await capture(url));
      } catch (e) {
        console.error("failed", url, e.message);
      }
    }
  })
);