api.gpdf.dev

PDFs from JSON, in one HTTP call.

Send a JSON template, get application/pdf back in the same response. Built on gpdf, a pure-Go PDF engine with Japanese, Chinese and Korean fonts built in.

500 free requests / month

No credit card

CJK out of the box

A PDF API without the browser.

No HTML, no headless Chrome, no queue to poll. The document is described in JSON and rendered directly.

JSON in, PDF out

A 12-column grid, tables, images, QR codes and barcodes, headers, footers and page numbers — all declared in one JSON template, with Go template data binding when you need it.

CJK built in

Noto Sans JP, KR and SC are available with no font setup. Mixed-script documents and line breaking rules work out of the box.

Synchronous by design

The response body is the PDF. There is no job ID, no webhook, and no signed URL to fetch afterwards.

One request, one count

A 100-page PDF costs the same as a 1-page one. Only successful responses count against your quota.

One POST. You get a PDF.

Use any HTTP client. The examples render the same single-page A4 document.

curl https://api.gpdf.dev/v1/pdf \
  -H "Authorization: Bearer $GPDF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template": {
      "page": { "size": "A4" },
      "body": [{ "text": "Hello, PDF!" }]
    }
  }' \
  --output hello.pdf

Questions we actually get.

How are requests counted against my quota?

Only successful 200 responses consume quota. 4xx and 5xx are free. A 100-page PDF counts as 1 request, same as a 1-page one.

How large can a document be?

The limit is on the request body: 600 KB on Free and 1.5 MB on Pro. That is roughly 50 and 120 pages of Japanese line items, or 70 and 180 pages in English. Larger requests get 413 document_too_large before any rendering happens.

How is CJK handled?

Noto Sans JP / KR / SC are built in and loaded on demand, in regular and bold. No font upload or configuration is needed.

Is the PDF engine open source?

Yes. The core engine gpdf is MIT-licensed pure Go with zero dependencies. The API service (gpdf-api) is closed source.

Does usage carry over between months?

No. Quotas reset at the start of each month (UTC). Add-on packs ($5 / 1,000 requests) are valid until the end of the month they were bought in.

Can I self-host?

Not yet. A self-hosted edition is planned but not available today. The PDF engine itself, gpdf, is open source and can be used directly from Go.

PDFs from JSON, in one HTTP call.

Send a JSON template, get application/pdf back in the same response. Built on gpdf, a pure-Go PDF engine with Japanese, Chinese and Korean fonts built in.

Start free