Screenshots

POST /v1/screenshots erfasst jede öffentliche Webseite als Bild oder PDF – keine Vorlage erforderlich.

# Anfrage

bash

curl https://api.mostlyrender.com/v1/screenshots \
  -H "Authorization: Bearer mr_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://stripe.com",
    "fullPage": true,
    "output": "png"
  }'

Feld	Typ	Notizen
`url`	string	Erforderlich. Eine öffentliche `http(s)` URL.
`width`	integer	Viewport-Breite. Standard `1200` (16–2400).
`height`	integer	Viewport-Höhe. Standard `630` (16–2400).
`fullPage`	boolean	Erfasst die gesamte Scrollhöhe. Standard `false`.
`scale`	number	Skalierungsfaktor des Geräts (Retina). Bis zu `3`.
`output`	string	`png` (Standard), `jpeg`, `webp` oder `pdf`.
`async`	boolean	Zur Warteschlange hinzufügen und `202` zurückgeben.
`webhookUrl`	string	Signierter Callback bei Abschluss (impliziert `async`).

# Antwort

json

{
  "id": "shot_abc123",
  "url": "https://img.mostlyrender.com/mostlyrender/screenshots/shot_abc123.png",
  "output": "png"
}

# URL-Sicherheit

Screenshots akzeptieren nur öffentliche http(s) URLs. Anfragen an private Bereiche, Loopback, Link-Local- oder Cloud-Metadaten-Hosts werden mit 400 abgelehnt – und die Sicherheitsprüfung überprüft nach jeder Umleitung erneut, sodass eine öffentliche URL nicht zu einer privaten Adresse umgeleitet werden kann.

# SDK

python

shot = mr.screenshot("https://stripe.com", full_page=True)
print(shot["url"])

Große Seiten können langsam sein – verwenden Sie dafür async + webhooks.