Screenshot (URL)

API key v1

Render any web page to JPEG, PNG or PDF at a chosen viewport.

Loads the page in a headless Chromium instance, waits for delay seconds so late-loading content settles, and saves a capture. The reply carries the URL of the saved file under /screen/url/s/.

POST https://api.zactonz.com/screen/url/

Parameters

Name	Type	Description
`url`required	string	Absolute URL of the page to capture.
`width`	integer	Viewport width in pixels. Default `1280`
`height`	integer	Viewport height in pixels. Default `1024`
`format`	enum	Output format. `jpegpngpdf`
`quality`	integer	JPEG quality from `1` to `100`. Ignored for other formats. Default `100`
`delay`	integer	Seconds to wait after the page loads before capturing. Default `5`
`download`	string	Any value. Stream the file instead of returning JSON.
`orientation`	enum	PDF only. `portraitlandscape`
`paperWidth`	number	PDF only. Paper width in inches. Default `6`
`paperHeight`	number	PDF only. Paper height in inches. Default `6`
`marginTop`	number	PDF only. Also `marginBottom`, `marginLeft`, `marginRight`. Inches. Default `0.4`
`scale`	number	PDF only. Render scale. Default `1`

Send parameters as application/x-www-form-urlencoded form fields in the request body.

Response

Metadata and the URL of the saved capture.

Field	Type	Description
`status`	string	`"200"` on success (a string). See status codes below.
`width`	integer	Viewport width that was used.
`height`	integer	Viewport height that was used.
`data`	string	Absolute URL of the saved image or PDF, or an error message.

Status codes

The outcome is reported in the JSON status field. See Errors & status codes for the general rules.

`200`	OK	The capture was saved. Note that this endpoint returns `status` as a string.
`400`	Bad request	`url` was missing, or `quality` was `0` for JPEG output.

Notes

Rendering a page takes a few seconds; allow a client timeout of at least 60 seconds. Pass download=1 to receive the file bytes directly (with Content-Disposition: attachment) instead of a JSON reply.

The PDF options (orientation, margins, paper size and scale) only apply when format=pdf. Margins and paper dimensions are in inches.

curl -X POST "https://api.zactonz.com/screen/url/" \ -H "Authorization: Bearer YOUR_API_KEY" \ --data-urlencode "url=https://zactonz.com" \ --data-urlencode "width=1280" \ --data-urlencode "height=1024" \ --data-urlencode "format=jpeg" \ --data-urlencode "quality=100" \ --data-urlencode "delay=5" \ --data-urlencode "orientation=portrait" \ --data-urlencode "paperWidth=6" \ --data-urlencode "paperHeight=6" \ --data-urlencode "marginTop=0.4" \ --data-urlencode "scale=1"

<?php $ch = curl_init("https://api.zactonz.com/screen/url/"); curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'], CURLOPT_POSTFIELDS => http_build_query([ 'url' => 'https://zactonz.com', 'width' => '1280', 'height' => '1024', 'format' => 'jpeg', 'quality' => '100', 'delay' => '5', 'orientation' => 'portrait', 'paperWidth' => '6', 'paperHeight' => '6', 'marginTop' => '0.4', 'scale' => '1', ]), ]); $result = json_decode(curl_exec($ch), true);

const res = await fetch("https://api.zactonz.com/screen/url/", { method: "POST", headers: { Authorization: "Bearer YOUR_API_KEY" }, body: new URLSearchParams({ url: "https://zactonz.com", width: "1280", height: "1024", format: "jpeg", quality: "100", delay: "5", orientation: "portrait", paperWidth: "6", paperHeight: "6", marginTop: "0.4", scale: "1", }), }); const result = await res.json();