Screenshot-API

Eine Screenshot-API ist ein Webdienst, der eine URL und Aufnahmeoptionen per HTTP-Anfrage entgegennimmt, die Seite auf eigenen Servern in einem Browser lädt und das Ergebnis als Bild oder PDF zurückgibt. Eine Anwendung kann damit Screenshots per Code anfordern, ohne selbst Browser installieren oder betreiben zu müssen.

Die meisten Dienste authentifizieren Anfragen mit einem API-Schlüssel und rechnen nach Anzahl der Aufnahmen ab. Funktionsumfang, Limits und Preise unterscheiden sich je nach Anbieter und ändern sich mit der Zeit. Vergleichen Sie sie daher anhand der Dokumentation des jeweiligen Anbieters.

So funktionieren Screenshot-APIs

1. Der Client sendet eine Anfrage mit der URL und Optionen wie Breite und Höhe des Viewports, ganzseitigem Bereich oder Viewport-Bereich, Geräteskalierungsfaktor, Format, Verzögerung und Wartebedingung.
2. Der Dienst öffnet die URL in einem Headless-Browser, der häufig über Playwright oder Puppeteer gesteuert wird.
3. Er wartet auf die Seite, wendet Optionen wie das Ausblenden von Cookie-Bannern oder Werbung an und erstellt die Aufnahme.
4. Er gibt das Bild direkt zurück oder speichert es und gibt einen Link zurück.

Wo Screenshot-APIs eingesetzt werden

• Bei Bedarf erzeugte Linkvorschauen und Social-Card-Bilder.
• Vorschaubilder von URLs, die Nutzer in Verzeichnissen oder CMS-Tools einreichen.
• Archivkopien von Seiten zur Dokumentation.
• Geplante Prüfungen, die Seiten über die Zeit vergleichen.

Gehostet oder selbst gehostet

Eine gehostete API nimmt Ihnen Wartung, Skalierung und Updates der Browser ab. Im Gegenzug laufen URLs und Bilder über einen Drittanbieter, und Seiten werden aus dem Netzwerk und der Region des Anbieters geladen, was Inhalte hinter Logins, VPNs oder Geo-Regeln verändern kann. Wenn Sie selbst mit Playwright oder Puppeteer hosten, bleiben die Daten in Ihrer Infrastruktur, Sie müssen aber Browser, Warteschlangen und Wiederholungsversuche selbst betreiben.

Häufige Fehler mit Screenshot-APIs

• Seiten, die einen Login erfordern, ohne Sitzungsdaten aufnehmen.
• Keine Wartebedingung festlegen, sodass halb geladene Seiten zurückkommen.
• Private oder interne URLs an einen Drittanbieterdienst senden.
• Ratenlimits und Timeouts bei umfangreichen Jobs ignorieren.

Immer wieder dieselben Screenshots?

Website Capture in Temposhot lädt die eingegebenen URLs in verwalteten lokalen Browsern auf Ihrem Mac und speichert die Dateien lokal. Die Funktion läuft in der App, nicht als HTTP-Dienst. Siehe Website-Screenshot-Automatisierung.

Häufige Fragen

Muss ich programmieren, um eine Screenshot-API zu nutzen?

Ja, zumindest für eine Anfrage aus einem Skript oder einem Automatisierungstool.

Kann eine Screenshot-API Seiten hinter einem Login aufnehmen?

Manche Dienste akzeptieren dafür Cookies oder Header. Prüfen Sie die Dokumentation des Anbieters und die Nutzungsbedingungen der Website.

Quellen

• Headless browser (Wikipedia)
• Playwright-Leitfaden zu Screenshots

Weiterführende Ressourcen

• Schnellstart für Website Capture: eine URL-Liste lokal aufnehmen.
• Optionen für Website Capture: Wartebedingungen und Umgang mit Cookie-Bannern.
• Läufe und Ergebnisse: Wiederholungsversuche und unvollständige Sitzungen.