Docs
Anmelden

Screenshots API

Rendern Sie jede URL als PNG oder JPEG. Nur Viewport oder vollseitig, Desktop oder Mobile, mit allen JS-Rendering-Steuerungen der Haupt-API. Perfekt für Vorschauen, Monitoring und Snapshots.

Wechseln Sie zur Crawling API (oder crawl_screenshot via MCP)

Dieselbe JS-Rendering-Pipeline, mit Screenshot-Parametern auf dem Standard-Endpoint ergänzt. Die eigenständige Screenshots API ist seit dem 1. November 2024 für Neuanmeldungen geschlossen — bestehende Integrationen funktionieren weiterhin, eine Abschaltung ist nicht geplant.

Endpoint

GEThttps://api.crawlbase.com/screenshots?token=YOUR_JS_TOKEN&url=ENCODED_URL
# Requires a JavaScript token (rendering happens in headless Chrome).
# Returns the image bytes directly. Content-Type: image/png (default).

Schnellstart

# Save the screenshot to disk
curl 'https://api.crawlbase.com/screenshots?token=YOUR_JS_TOKEN' \
  --data-urlencode 'url=https://github.com/anthropic' \
  -o screenshot.png -G
from crawlbase import ScreenshotsAPI

api = ScreenshotsAPI({'token': 'YOUR_JS_TOKEN'})
res = api.get('https://github.com/anthropic')

with open('screenshot.png', 'wb') as f:
    f.write(res['body'])
const { ScreenshotsAPI } = require('crawlbase');
const fs = require('node:fs/promises');

const api = new ScreenshotsAPI({ token: 'YOUR_JS_TOKEN' });
const res = await api.get('https://github.com/anthropic');
await fs.writeFile('screenshot.png', res.body);

Parameter

Erforderlich

token
stringerforderlich
Ihr privates Crawlbase token.
url
stringerforderlich
URL der Zielseite. Muss mit http oder https beginnen und vollständig URL-kodiert sein.

Screenshot-spezifisch

mode
viewport | fullpageviewport
Erfassen Sie nur den sichtbaren Bereich oder die gesamte scrollbare Seite.
format
png | jpegpng
PNG für gestochen scharfen Text und UI; JPEG für kleinere Payloads bei bildlastigen Seiten.
width
int (px)1280
Viewport-Breite.
height
int (px)800
Viewport-Höhe. Wird ignoriert, wenn mode=fullpage.
device
desktop | mobiledesktop
Verwenden Sie ein voreingestelltes Geräteprofil. Mobile-Presets erzwingen width=375, height=812 und einen Phone-User-Agent.
store
booleanfalse
Speichern Sie den Screenshot dauerhaft in Cloud Storage. Bei true enthält die Response einen screenshot_url-Header, der auf die gespeicherte Kopie verweist — nützlich, wenn Sie eine stabile URL benötigen, um sie in Dashboards einzubetten oder mit nachgelagerten Systemen zu teilen.

Rendering-Steuerung

Übernommen vom Crawling API-Parametersatz. Die Rendering-Steuerungen, die Clients am häufigsten mit Screenshots verwenden:

user_agent
stringoptional
Benutzerdefinierter User-Agent, der unverändert an die Zielseite weitergeleitet wird. URL-kodieren Sie ihn. Wenn weggelassen, rotiert Crawlbase pro Request einen realistischen UA.
css_click_selector
stringoptional
CSS-Selektor für ein Element, das vor der Screenshot-Aufnahme angeklickt werden soll (#some-button, .some-other-button). URL-kodieren Sie den Wert.
scroll
booleanfalse
Scrollen Sie die Seite vor der Aufnahme automatisch. Standardmäßig 10 Sekunden Scrollen. Kombinieren Sie mit scroll_interval (10–60 s), um die Dauer zu verlängern. Nützlich für lazy-geladene Inhalte oberhalb des Fold-Bereichs bei einer mode=fullpage-Aufnahme.
page_wait
integer (ms)optional
Warten Sie nach dem Laden der Seite die angegebene Anzahl Millisekunden, bevor die Aufnahme erfolgt — gibt Animationen oder JS-lastigen Renderings Zeit, sich zu stabilisieren.
ajax_wait
booleanfalse
Warten Sie, bis laufende AJAX-Requests abgeschlossen sind, bevor die Aufnahme erfolgt.
country
ISO 3166optional
Geolokalisieren Sie den Screenshot aus einem bestimmten Land (z. B. US, GB, DE). Die Länderverfügbarkeit hängt vom Tarif ab; die vollständige Länderliste finden Sie in der Crawling API-Parameterreferenz.

Häufige Muster

Vollseitiger Mobile-Screenshot

curl 'https://api.crawlbase.com/screenshots?token=YOUR_JS_TOKEN' \
  --data-urlencode 'url=https://news.ycombinator.com' \
  --data-urlencode 'mode=fullpage' \
  --data-urlencode 'device=mobile' \
  --data-urlencode 'format=jpeg' \
  -o hn-mobile.jpg -G

Screenshot nach einem Klick

# Open a "Show details" panel before capturing
curl 'https://api.crawlbase.com/screenshots?token=YOUR_JS_TOKEN' \
  --data-urlencode 'url=https://example.com/product/123' \
  --data-urlencode 'css_click_selector=button.show-details' \
  --data-urlencode 'page_wait=1500' \
  -o detail.png -G

Häufige Anwendungsfälle

  • Link-Vorschauen — generieren Sie Open-Graph-Fallbacks für Seiten ohne korrekte Meta-Tags.
  • Visuelles Monitoring — erfassen Sie eine Seite wöchentlich, um Layout-Regressionen zu erkennen.
  • Compliance-Archive — kombinieren Sie mit Cloud Storage, um zu archivieren, wie eine Seite an einem bestimmten Datum aussah.
  • E-Mail-Reports — betten Sie Live-Screenshots in geplante Reports ein.