Quickstart

Open spoolpdf.nandra.dev and sign in with Google, GitHub, or a magic link. Confirm /dashboard shows plan free.

Create an API key

Open API keys, create a key, and copy the spool_live_… value once.

export SPOOLPDF_API_KEY='spool_live_…'
export SPOOLPDF_BASE_URL='https://spoolpdf-api.nandra.dev'

Render HTML

curl -sS -D - -o first.pdf \
  -X POST "$SPOOLPDF_BASE_URL/v1/render" \
  -H "Authorization: Bearer $SPOOLPDF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"html":"<h1>Hello spoolpdf</h1>"}'

Expect 200, Content-Type: application/pdf, X-Request-Id, and X-Usage-Count.

Prefer html when you control the markup. URL renders are slower and reject private or loopback hosts (ssrf_blocked).

Local Compose

API at http://localhost:8080. Create the key in the local dashboard at http://localhost:3000/keys, then set SPOOLPDF_BASE_URL=http://localhost:8080.

Try without a key

POST /v1/trial/render is IP rate-limited and does not increment usage. See Trial.

Chat clients

Skip the key in ChatGPT or Claude. Connect MCP from the dashboard /mcp page.

Next: authentication, HTML to PDF, or the Node and PHP SDKs.

⌘I

Get started

Render

Integrate