Screenshots

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

# Request

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"
  }'

Field	Type	Notes
`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	Erfasse die vollständige Scroll-Höhe. Standard `false`.
`scale`	number	Geräte-Skalierungsfaktor (Retina). Bis zu `3`.
`output`	string	`png` (Standard), `jpeg`, `webp` oder `pdf`.
`paper`	string	Mit `output: "pdf"` in ein Dokument dieser Papiergröße (`A4`, `A3`, `A5`, `Letter`, `Legal`, `Tabloid`, `Ledger`) mit Rändern paginieren, anstatt einer einzigen Erfassung in voller Höhe.
`async`	boolean	In Warteschlange einreihen und `202` zurückgeben.
`webhookUrl`	string	Signierter Callback bei Fertigstellung (impliziert `async`).
`notifyEmail`	string	Diese Adresse per E-Mail benachrichtigen, wenn der Job fertig ist (impliziert `async`).

# Response

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 Schutzmaßnahme prüft nach jeder Umleitung erneut, damit eine öffentliche URL nicht zu einer internen umgeleitet werden kann.

# SDK

python

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

Große Seiten können langsam sein – verwende für diese async + webhooks.