Live Playground
API Endpoint
All requests are GET requests and should be sent to the following endpoint:
https://screenapi.vocalio.sk/api/screenshot
URL Builder
Copied to clipboard!
Parameters
| Parameter | Required | Description & Rules |
|---|---|---|
url |
Yes | The URL of the page to screenshot. |
dimension |
Yes | Viewport dimensions in WIDTHxHEIGHT format. |
device |
No | Emulate a device. Options: desktop, phone, tablet. |
format |
No | Output format. Options: jpg (default), png, gif. |
delay |
No | Time in milliseconds (ms) to delay the screenshot. Min: 0, Max: 10000. |
zoom |
No | Zoom level in percent. Range: 10-400. |
click |
No | CSS selector of an element to click before taking the screenshot. |
hide |
No | CSS selector of elements to hide (e.g., cookie banners). |
cookies |
No | Cookie string to set, e.g. name1=value1; name2=value2. |
accept-language |
No | Value for the Accept-Language HTTP header. |
user-agent |
No | Custom User-Agent string. |
selector |
No | CSS selector of an element to capture. Only this element will be screenshotted. |
crop |
No | Crop the final image, format: x,y,width,height. |
Responses
Successful Response: 200 OK
On success, the API returns the binary image data directly.
Error Response: 4xx/5xx
If an error occurs, the API will return a JSON object with error details.
PDF Live Playground
PDF Endpoint
GET https://screenapi.vocalio.sk/api/pdf
PDF URL Builder
Copied to clipboard!
PDF Parameters
| Parameter | Required | Description & Rules |
|---|---|---|
url |
Yes | The URL of the page to convert. |
paper |
No | Page size. Default: A4. Accepts: letter, legal, A0-A6, etc. |
orientation |
No | Page orientation. Default: portrait. Accepts: portrait, landscape. |
media |
No | Emulate media. Default: screen. Accepts: screen, print. |
bg |
No | Include background. Default: bg. Accepts: bg, nobg. |
delay |
No | Time in milliseconds (ms) to delay the action. Min: 0, Max: 10000. |
scale |
No | Scale of the webpage rendering. Default: 1. Range: 0.1 to 2. |
click |
No | CSS selector of an element to click before the action. |
hide |
No | CSS selector of elements to hide. |
cookies |
No | Cookie string to set, e.g. name1=value1. |
accept-language |
No | Value for the Accept-Language HTTP header. |
user-agent |
No | Custom User-Agent string. |
Responses
Successful Response: 200 OK
On success, the API returns the binary PDF data directly with a Content-Type: application/pdf header.
Error Response: 4xx/5xx
If an error occurs, the API will return a JSON object with error details.