Generate PDFs from URLs, HTML, or Markdown via API

1
// Node.js 22+. Save as url-to-pdf.mjs and run on your server.
2
import { writeFile } from "node:fs/promises";
3

4
const accessKey = process.env.SCREENSHOTONE_ACCESS_KEY;
5
if (!accessKey) throw new Error("Set SCREENSHOTONE_ACCESS_KEY first.");
6

7
const response = await fetch("https://api.screenshotone.com/take", {
8
    method: "POST",
9
    headers: { "Content-Type": "application/json", "X-Access-Key": accessKey },
10
    body: JSON.stringify({
11
        url: "https://example.com/",
12
        format: "pdf",
13
        pdf_paper_format: "a4",
14
        pdf_margin: "12mm",
15
        pdf_print_background: true,
16
        media_type: "print",
17
    }),
18
    signal: AbortSignal.timeout(120_000),
19
});
20
if (!response.ok) throw new Error(`PDF request failed: HTTP ${response.status}`);
21

22
const pdf = Buffer.from(await response.arrayBuffer());
23
if (pdf.subarray(0, 5).toString() !== "%PDF-") {
24
    throw new Error("The response was not a PDF.");
25
}
26
await writeFile("example.pdf", pdf);

1
import json
2
import os
3
from pathlib import Path
4
from urllib.request import Request, urlopen
5

6
request = Request(
7
    "https://api.screenshotone.com/take",
8
    data=json.dumps({
9
        "url": "https://example.com/",
10
        "format": "pdf",
11
        "pdf_paper_format": "a4",
12
        "pdf_margin": "12mm",
13
        "pdf_print_background": True,
14
        "media_type": "print",
15
    }).encode("utf-8"),
16
    headers={
17
        "Content-Type": "application/json",
18
        "X-Access-Key": os.environ["SCREENSHOTONE_ACCESS_KEY"],
19
    },
20
    method="POST",
21
)
22
# HTTP errors raise before the output file is written.
23
with urlopen(request, timeout=120) as response:
24
    pdf = response.read()
25
if not pdf.startswith(b"%PDF-"):
26
    raise ValueError("The response was not a PDF.")
27
Path("example.pdf").write_bytes(pdf)