Skip to content
Help Center Screenshots PDF Generation Options

Screenshots

PDF Generation Options

Generate a PDF alongside the screenshot with custom format, margins, and orientation.

Enabling PDF generation

Add "pdf": true to your screenshot request to generate a PDF in addition to the image:

{
  "url": "https://example.com",
  "pdf": true
}

Retrieve the PDF via GET /api/v1/screenshot/pdf?id={screenshot_id}.

Page format

Set pdf_format to control the paper size. Supported values include: letter (default), legal, tabloid, a0a6.

Margins

Use pdf_margin for uniform margins, or set individual sides:

{
  "pdf": true,
  "pdf_margin": "20px",
  "pdf_margin_top": "10mm",
  "pdf_margin_bottom": "10mm"
}

Values accept CSS units: px, mm, cm, in.

Other options

  • pdf_landscape — render in landscape orientation.
  • pdf_background — print background colors and images (default: false).
  • pdf_one_page — force the entire page content onto a single PDF page.

Last updated March 27, 2026