# spoolpdf

> HTML and URL to PDF API. Chromium rendering, Polar metering, Node and PHP SDKs, remote MCP.

- [spoolpdf](https://docs.spoolpdf.nandra.dev/index.md): HTML or a public URL to PDF. Sign in, create a key, and call POST /v1/render.
- [Quickstart](https://docs.spoolpdf.nandra.dev/quickstart.md): Render a first PDF in a few minutes.
- [Authentication](https://docs.spoolpdf.nandra.dev/authentication.md): Bearer API keys for POST /v1/render. MCP uses dashboard OAuth instead.
- [Errors](https://docs.spoolpdf.nandra.dev/errors.md): JSON error envelope and codes returned by the render API.
- [HTML to PDF](https://docs.spoolpdf.nandra.dev/guides/html-to-pdf.md): Send HTML you already have. Fastest path and no SSRF check.
- [URL to PDF](https://docs.spoolpdf.nandra.dev/guides/url-to-pdf.md): Render a public http(s) page. Private hosts return ssrf_blocked.
- [Layout](https://docs.spoolpdf.nandra.dev/guides/layout.md): Paper size, single page, margins, header, and footer.
- [Waits, cookies, and auth](https://docs.spoolpdf.nandra.dev/guides/waits-and-auth.md): SPA waits, extra HTTP headers, cookies, and HTTP Basic auth.
- [Sandbox, pages, and inject](https://docs.spoolpdf.nandra.dev/guides/sandbox.md): Unmetered watermarked previews, page ranges, CSS/JS inject, metadata, and lazy images.
- [Node and PHP SDKs](https://docs.spoolpdf.nandra.dev/guides/sdks.md): Official clients for POST /v1/render.
- [MCP (ChatGPT, Claude, Cursor)](https://docs.spoolpdf.nandra.dev/guides/mcp.md): Render PDFs from chat without pasting an API key.
- [Trial render](https://docs.spoolpdf.nandra.dev/guides/trial.md): Smoke-test POST /v1/trial/render without an API key.
- [API overview](https://docs.spoolpdf.nandra.dev/api-reference/overview.md): POST /v1/render request body, success headers, and related endpoints.
- [Render PDF (authenticated)](https://docs.spoolpdf.nandra.dev/api-reference/render/render-pdf-authenticated.md): Convert HTML or a public URL to PDF. Exactly one of `html` or `url`.
- [Trial render (IP rate-limited)](https://docs.spoolpdf.nandra.dev/api-reference/trial/trial-render-ip-rate-limited.md): Same body as `POST /v1/render`, without an API key. Does not increment usage. IP rate-limited. Not for production volume.
- [Liveness](https://docs.spoolpdf.nandra.dev/api-reference/health/liveness.md)
- [Readiness (probes Gotenberg and Postgres)](https://docs.spoolpdf.nandra.dev/api-reference/health/readiness-probes-gotenberg-and-postgres.md)

## OpenAPI Specs

- [openapi](/openapi.yaml)