clause-netizen/snappdf-api

SnapPDF is a hosted web service that turns any web page into a clean, print ready PDF file with a single HTTP request. It works by rendering the page with a headless version of Chromium, meaning the browser runs in the background without a visible window, and it gives you control over the paper format, orientation, scale, and whether background colors and images are included. The service exposes a simple API with two endpoints: one that takes a URL and query options and returns the rendered PDF as bytes, and a health check endpoint used to confirm the service is running. Supported paper formats include A4, A3, A5, Letter, Legal, and Tabloid, and you can also choose landscape mode, a print scale, and whether to keep printed backgrounds. The full technical contract is defined in an OpenAPI specification file included in the repository. The README suggests this is meant for things like generating invoices and receipts, exporting reports or dashboards, archiving web pages, powering a download as PDF button on a website, or any backend system that needs to turn a page into a PDF without having to install and manage Chromium itself. Using it is as simple as sending a request to the hosted API with the target URL and desired options, either through a command line tool like curl or from JavaScript code using the built in fetch function, then saving the returned bytes as a PDF file. This particular repository holds the client examples and the API specification rather than the server code itself, since the actual API is run and hosted separately by the SnapPDF project. It is released under the MIT license.