API changelog

Fixes and behaviour changes to the capture API, most recent first. This page is in English on both domains.

output_size

output_size applies at any width

A width outside the documented list was silently replaced by viewport_width, so the parameter looked inert. Unsupported values now return 400 invalid_output_size, and Shotbot Pro can request any width from 16 to 3840 px, so a single render can serve a whole srcset instead of one file per layout.

Captures requested wider than the viewport also came back shorter than the height they reported. They now match it.

format=pdf

PDF page sizes come out exact

A4, A3 and A5 rendered a fraction of a millimetre over their nominal size. On a document with a dark background, that left a thin unpainted strip along two edges. Every page size now measures exactly, in portrait and landscape, on both /capture and /capture/batch.

crop_height

crop_height no longer forces a full-page capture

Setting crop_height switched the capture to full page and cropped from the top. Every preset sets it, so presets rendered the entire page, and anything pinned to the bottom of the viewport landed in the wrong place. Presets now capture a real viewport.

Something behaving differently?

If a parameter does not do what the API reference says it does, tell us. The fix at the top of this page came from a report like that.