URL zu PDF

Was die Seite erfüllen muss

Die Adresse muss über HTTPS aus dem öffentlichen Internet antworten. Private, Loopback- und interne Adressen werden abgelehnt, und auch nichts, was die Seite lädt, ein Bild, ein Skript, eine Schrift, darf von einer solchen Adresse kommen, wohin eine Weiterleitung auch führt. Eine Seite, die mit einem HTTP-Fehler antwortet oder nicht erreichbar ist, lässt das Rendering mit navigation_failed fehlschlagen, und ein fehlgeschlagenes Rendering wird nicht gezählt.

Die Anfrage trägt keine Cookies und keine Header von Ihnen; eine Seite hinter einem Login zeigt dem Renderer also ihr Anmeldeformular. Für eine solche Seite bauen Sie das HTML dort, wo die Sitzung ist, und senden es als html: HTML zu PDF. Eine Website, die automatisierte Browser abweist, antwortet auch dem Renderer mit ihrer Prüfung.

Papier, Ränder und das Print-Stylesheet der Seite

Ein PDF ist die Seite, wie ihr Print-Stylesheet sie setzt, so wie der Druckdialog eines Browsers sie zeigen würde. Papier, Ausrichtung und Ränder kommen aus settings, A4 hochkant, solange Sie nichts anderes sagen, eine Kopf- und eine Fußzeile können sich auf jeder Seite wiederholen, und mit preferCssPageSize entscheidet stattdessen eine @page-Regel der Seite über das Format.

{
  "url": "https://example.com/reports/2026-09",
  "settings": {
    "paper": { "format": "A4", "landscape": true },
    "margin": { "top": "15mm", "right": "12mm", "bottom": "18mm", "left": "12mm" },
    "footer": {
      "height": "10mm",
      "html": "<div style=\"width:100%;text-align:center;font-size:8px\"><span class=\"pageNumber\"></span> / <span class=\"totalPages\"></span></div>"
    }
  }
}

Zum Drucken ist die Seite so breit wie das Papier abzüglich seiner Ränder, und A4 hochkant ist 794 CSS-Pixel breit; eine responsive Seite druckt also das Layout, das sie für ein schmales Fenster hat. Querformat oder ein größeres Papier gibt ihr mehr Platz, scale verkleinert oder vergrößert den Inhalt zwischen 0,1 und 2, und pageRanges behält nur die Seiten, die Sie nennen. Kopf- und Fußzeile werden außerhalb der Seite gedruckt und tragen ihre eigenen Inline-Styles.

Ein Screenshot statt eines PDFs

Mit "output": "png", "jpg" oder "webp" wird die Seite nicht gedruckt, sondern so aufgenommen, wie der Bildschirm sie zeigt, mit ihren Bildschirm-Styles. settings.image setzt das Fenster: Breite und Höhe in CSS-Pixeln, 1200 × 630, solange Sie nichts anderes sagen, und deviceScaleFactor, der standardmäßig 2 ist und die Pixel der Datei verdoppelt. fullPage nimmt die ganze Länge der Seite auf, clipSelector ein einzelnes Element, und quality setzt die Kompression von JPG und WebP.

{
  "url": "https://example.com/reports/2026-09",
  "output": "png",
  "settings": {
    "image": { "width": 1440, "height": 900, "deviceScaleFactor": 1, "fullPage": true }
  }
}

Für das Vorschaubild einer eigenen Seite ist eine Vorlage die bessere Quelle als ein Screenshot: Open-Graph-Bild-API.

Seiten, die spät fertig werden

Eine Seite, die sich mit JavaScript selbst aufbaut, wird aufgenommen, wenn sie fertig ist, nicht wenn ihr erstes Byte ankommt: Der Renderer wartet auf das Load-Ereignis, auf Ruhe im Netzwerk und auf die Schriften. Wo das nicht reicht, wartet waitFor.selector auf ein Element, fünf Sekunden, solange waitFor.timeoutMs nichts anderes sagt, und waitFor.delayMs fügt eine Pause von bis zu zehn Sekunden hinzu. Eine Seite, die eine Verbindung offen hält, wird nie ruhig: waitFor.networkIdle: false nimmt sie direkt nach dem Load-Ereignis auf.

Eine Seite hat 30 Sekunden zum Laden. Eine Anfrage, auf die niemand warten soll, geht mit "mode": "async" hinaus und meldet sich per Webhook, und eine Liste von Adressen ist ein Batch: bis zu 1.000 Seiten in einer Anfrage.

Jede Anfrage lädt die Seite neu

Ein Live-Rendering aus einer Vorlage wird aus der gespeicherten Datei beantwortet, wenn die identische Anfrage innerhalb von 24 Stunden noch einmal kommt. Bei einer URL ist das anders: Die Seite dahinter kann sich geändert haben, ein URL-Rendering wird deshalb nie aus einem früheren beantwortet. Jede Anfrage öffnet die Seite, zeigt sie, wie sie in diesem Moment ist, und zählt als Rendering. Damit eine Wiederholung sicher ist, senden Sie einen Idempotency-Key: Sobald die erste Anfrage beantwortet ist, liefert derselbe Schlüssel 24 Stunden lang diese Antwort, und nichts wird doppelt gerendert.

Jedes Rendering beginnt in einem frischen Browser ohne Cookies und ohne Speicher, mit der Sprache en-GB und der Zeitzone Europe/Berlin, solange settings.locale und settings.timezone keine anderen nennen. Eine Seite, die einen ersten Besuch mit einem Consent-Banner begrüßt, zeigt es in der Aufnahme; im PDF fehlt es nur, wo das Print-Stylesheet der Seite es ausblendet, und image.clipSelector nimmt ein Element statt des Fensters auf. Die Seite, ihre Stylesheets und ihre Skripte werden jedes Mal neu geladen; ihre Bilder und Schriften können aus dem Cache des Renderers kommen, der eine Datei unter ihrer Adresse bis zu eine Woche behält.

Wenn die Seite Ihre eigene ist

Eine Adresse zu drucken, ist der kurze Weg für eine Seite, die es ohnehin gibt. Ist die Seite Ihre eigene und existiert nur, um ein PDF zu werden, eine Quittung, ein Bericht, ein Ticket, dann ist das Layout als Vorlage besser aufgehoben: Die Anfrage trägt die Daten statt einer Adresse, nichts muss aus dem Internet erreichbar sein, eine identische Live-Anfrage innerhalb von 24 Stunden kostet beim zweiten Mal nichts, und der Editor zeigt die Seiten, bevor etwas gesendet wird. HTML, das Ihr Server ohnehin rendert, kann so, wie es ist, als html kommen.

Was eine Seite kostet

Ein PDF mit bis zu fünf Seiten ist eine Einheit, und jede weiteren fünf Seiten kosten eine mehr; ein Screenshot ist eine Einheit. Der Free-Plan hat 100 Einheiten im Monat und verlangt keine Kreditkarte, und seine PDFs dürfen bis zu 20 Seiten haben. Starter hat 3.000 Einheiten für 19 € im Monat und druckt bis zu 200 Seiten. Renderings mit einem Test-Schlüssel kosten nichts, und ein fehlgeschlagenes Rendering wird nie gezählt. Alle Pläne stehen auf der Preisseite.