Quickstart

Create an API key, send one request, and get a rendered file back.

Three steps and a file lands on disk.

Create an account

Create an API key

Open the dashboard, go to API Keys, and create one.

The key is shown once, at creation. Store it as a server-side secret — anyone holding it can spend your render quota.

Render something

Post a complete HTML document and write the bytes to a file.

curl -X POST https://api.snhtml.com/v1/render \
  -H "authorization: Bearer snhtml_..." \
  -H "content-type: application/json" \
  -d '{
    "html": "<main><h1>Invoice #1842</h1></main>",
    "format": "png",
    "width": 1024,
    "height": 900
  }' \
  --output invoice-1842.png

const response = await fetch("https://api.snhtml.com/v1/render", {
  method: "POST",
  headers: {
    authorization: `Bearer ${process.env.SNAPHTML_API_KEY}`,
    "content-type": "application/json",
  },
  body: JSON.stringify({
    html: "<main><h1>Invoice #1842</h1></main>",
    format: "png",
    width: 1024,
    height: 900,
    fileName: "invoice-1842",
  }),
});

if (!response.ok) {
  const { error } = await response.json();
  throw new Error(error);
}

const bytes = Buffer.from(await response.arrayBuffer());

import os
import requests

response = requests.post(
    "https://api.snhtml.com/v1/render",
    headers={"authorization": f"Bearer {os.environ['SNAPHTML_API_KEY']}"},
    json={
        "html": "<main><h1>Invoice #1842</h1></main>",
        "format": "pdf",
        "pdfFormat": "A4",
    },
    timeout=30,
)
response.raise_for_status()

with open("invoice-1842.pdf", "wb") as file:
    file.write(response.content)

Try it without writing code

The dashboard’s Sandbox runs the same request from the browser: paste HTML or pick a template, choose a format, and download the result. Sandbox renders count toward your monthly usage, exactly like API renders.

HTTP API

Endpoints, headers, and response shape.

Render options

Viewport, waiting, image and PDF settings.

Templates

Store HTML once, fill it per customer.

Errors

Status codes and what to do about them.

Quickstart

Try it without writing code

Next