Screenshot

Capture a screenshot of any web page with configurable viewport dimensions, image format, and full-page mode.

POST /api/screenshot

Parameters

Field	Type	Required	Default	Description
url	string	Yes	—	URL to capture
width	integer	No	1280	Viewport width in pixels (max 3840)
height	integer	No	720	Viewport height in pixels (max 2160)
format	string	No	png	png, jpeg, or webp
quality	integer	No	85	Compression quality 0–100 (jpeg and webp only)
full	boolean	No	false	Capture the full scrollable page

Response

Binary image data with the appropriate Content-Type header.

Examples

Basic screenshot

curl -X POST https://morso.dev/api/screenshot \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}' \
  -o screenshot.png

Full-page JPEG

curl -X POST https://morso.dev/api/screenshot \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "format": "jpeg", "quality": 90, "full": true}' \
  -o screenshot.jpg

Custom viewport

curl -X POST https://morso.dev/api/screenshot \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "width": 375, "height": 812, "format": "webp"}' \
  -o mobile.webp

Errors

• 400 — Missing URL, dimensions exceed limits, or invalid format.
• 500 — Browser unavailable or page navigation timeout.

See Errors for the standard error shape.