Skip to content

Screenshot route body parameters

To render a screenshot, set screenshot under the page property:

screenshot properties for screenshot routes

These properties follow Puppeteer's ScreenshotOptions type.

Property nameTypeDescription
captureBeyondViewportbooleanCaptures the screenshot beyond the visible viewport. optional
clipScreenshotClipAn object which specifies the clipping region of the page. optional
fullPagebooleanWhen true, takes a screenshot of the full page. optional
omitBackgroundbooleanHides default white background and allows capturing screenshots with transparency. optional
qualitynumberImage quality, between 0 and 100. Not applicable to PNG images. optional
type'png', 'jpg', 'jpeg', 'webp'Image format, default is png. optional

⚠️ WARNING

  • clip and fullPage cannot be used at the same time. They are mutually exclusive.
  • quality cannot be used with the PNG format.
  • If you define quality, you must also set type to jpg, jpeg, or webp.

clip properties

Property nameTypeDescription
widthnumberWidth of the area to capture.
heightnumberHeight of the area to capture.
xnumberX coordinate of the capture area.
ynumberY coordinate of the capture area.

All rights reserved