Screenshots

POST /v1/screenshots legt elke openbare webpagina vast als afbeelding of PDF — geen sjabloon vereist.

# 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	Verplicht. Een openbare `http(s)` URL.
`width`	integer	Breedte van de viewport. Standaard `1200` (16–2400).
`height`	integer	Hoogte van de viewport. Standaard `630` (16–2400).
`fullPage`	boolean	Leg de volledige scroolhoogte vast. Standaard `false`.
`scale`	number	Schaalbaarheid van het apparaat (retina). Tot `3`.
`output`	string	`png` (standaard), `jpeg`, `webp`, of `pdf`.
`paper`	string	Met `output: "pdf"`, pagina’s in een document van deze papiergrootte (`A4`, `A3`, `A5`, `Letter`, `Legal`, `Tabloid`, `Ledger`) met marges, in plaats van één volledige afbeelding.
`async`	boolean	In wachtrij plaatsen en `202` retourneren.
`webhookUrl`	string	Ondertekende callback bij voltooiing (impliceert `async`).
`notifyEmail`	string	Stuur een e-mail naar dit adres wanneer de taak is voltooid (impliceert `async`).

# Response

json

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

# URL-veiligheid

Screenshots accepteren alleen openbare http(s) URL’s. Verzoeken naar privéreeksen, loopback, link-local, of cloud-metagegevensdieën worden afgewezen met 400 — en de bewaker controleert opnieuw na elke omleiding, dus een openbare URL kan niet naar een interne springen.

# SDK

python

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

Grote pagina’s kunnen traag zijn — gebruik voor die async + webhooks.