apyhub
FILE MANIPULATION

Generate Sized Screenshot API

What it does

Full Page Screenshot captures a PNG screenshot of any URL, with support for browser sizing and page-wait controls. Send a url, and optionally set width, height, wait_ms, and full_page to control how the page is rendered before the image is returned.

Use it when you need a visual snapshot of a web page for QA, audits, documentation, archiving, or monitoring. The response is binary PNG data, so you can store the image, attach it to reports, or feed it into downstream image workflows.

Full Page Screenshot is useful for checking layout issues across different viewport sizes, verifying content after client-side rendering, or capturing a complete page for records. If the page loads slowly or depends on scripts, increase wait_ms before capture; if you only need the visible viewport, set full_page accordingly.

It is a straightforward way to turn a live URL into an image artifact your app can save, compare, or share.

GET
Capture a full-page PNG screenshot of any URL
http://localhost:8080/dosvak/generate-screenshot
QUICKSTARTGUIDE

Quickstart

Capture a webpage screenshot by passing the target url as a query parameter.

curl -X GET "http://localhost:8080/dosvak/generate-screenshot?url=https%3A%2F%2Fexample.com" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns the screenshot as a binary file (format: binary), not JSON.

TRY ITLIVE · 10 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Captures a PNG screenshot of the URL you provide and returns the image as binary data. You can control the viewport size, how long the capture waits before taking the screenshot, and whether the capture should include the full page.

Query Parameter(s)

AttributeTypeMandatoryDescription
urlStringYesThe URL to capture.
widthIntegerNoViewport width in pixels.<br>Default: 1280.<br>Minimum: 320.<br>Maximum: 1920.
heightIntegerNoViewport height in pixels.<br>Default: 800.<br>Minimum: 240.<br>Maximum: 1080.
wait_msIntegerNoTime to wait before capturing, in milliseconds.<br>Default: 1500.<br>Minimum: 0.<br>Maximum: 8000.
full_pageBooleanNoWhether to capture the full page.<br>Default: true.

Response

Returns a binary PNG image. The output schema is a top-level binary string, so the success response is the screenshot file itself rather than a JSON object.

ParameterTypeMandatoryDescription
valueStringYesBinary PNG screenshot data.

Query parameters

Name
Type
Description
urlREQUIRED
string
widthOPTIONAL
integer
DEFAULT 1280
heightOPTIONAL
integer
DEFAULT 800
wait_msOPTIONAL
integer
DEFAULT 1500
full_pageOPTIONAL
boolean
DEFAULT true
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.