apyhub
Back

Webpage Screenshot from URL API

What it does

Webpage Screenshot lets you capture any web page as an image from its URL. Send a GET request to /take-screenshot with the page url, plus the width and height you want, and get back a JPEG (image/jpeg) of exactly that size.

url, width, and height are all required. width and height set the size of the browser viewport, and the page is captured 1:1 at that size, so text stays sharp. Both accept values from 100 to 1920 pixels, and values outside that range are clamped. Small widths show the site's mobile layout, which makes it easy to check how a page looks on different screens.

The response is the image itself and not JSON, so you can save it to a file, display it in your app, or hand it to the next step of a workflow directly.

Use Webpage Screenshot when you need link previews, website thumbnails, visual monitoring and archiving, or responsive layout checks without running your own headless browser.

  • They run about 1,000 to 1,100 characters each, in line with the catalog's median of about 1,050.
  • I only used details from each endpoint's own docs and schema (GET, the paths, required fields and limits). I didn't add related-service links, because the ingredient service has them only because its sibling services have known URLs.
  • I'm not sure the crop behavior is documented beyond "controls whether the image is cropped". If the provider can clarify what crop does, add that sentence.
GET
Screenshot API
https://api.eu.apyhub.com/skycraft/webpage-screenshot-api/take-screenshot

QUICKSTART

GUIDE

Quickstart

Take a screenshot of a webpage by passing the page URL and desired image size as query parameters.

curl -X GET "https://api.eu.apyhub.com/skycraft/webpage-screenshot-api/take-screenshot?url=https://apyhub.com&width=400&height=300" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns the screenshot as a binary file, not JSON.

TRY ITLIVE · 20 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

Takes a screenshot of the web page at the specified URL and returns it as a JPEG image. width and height are the size of the browser viewport: the page is captured 1:1 at that size, so the text is sharp and small widths show the site's mobile layout.

Query Parameter(s)

AttributeTypeDescription
urlStringThe webpage URL to capture. Maximum length: 1000 characters.
widthIntegerViewport (and image) width in pixels. Minimum: 100, maximum: 1920; values outside the range are clamped.
heightIntegerViewport (and image) height in pixels. Minimum: 100, maximum: 1920; values outside the range are clamped.

Response

Returns the screenshot as a JPEG image (image/jpeg) of exactly width x height pixels.

▣ 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.