Website Screenshot
Loads a public URL in a real browser at the viewport you choose, waits for web fonts and the network to settle, then captures the visible area or the whole scrolling page. Requests to private or link-local addresses are refused, and ad/tracker hosts can be dropped before they render.
Every call starts and tears down a headless Chromium instance, which is an order of magnitude heavier than an HTTP fetch.
Any HTTP client works. Replace the key with one from your dashboard.
curl -X POST https://toolkitbackend-j69m.onrender.com/api/v1/tools/website-screenshot \
-H "Authorization: Bearer tb_live_<your_api_key>" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com",
"width": 1440,
"height": 900,
"fullPage": true,
"deviceScaleFactor": 1,
"format": "png",
"quality": 85,
"blockAds": true,
"hideOverlays": false
}'Input
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
url | string | required | - | Public http(s) address to capture. |
width | integer | optional | 1440 | Viewport width in CSS pixels. The page lays itself out at this width, so responsive breakpoints apply. |
height | integer | optional | 900 | Viewport height in CSS pixels. Ignored when fullPage is true. |
fullPage | boolean | optional | false | Capture the entire scrollable page. Scrolls first so lazy-loaded images are present. |
deviceScaleFactor | integer | optional | 1 | 1 for standard density, 2 for a Retina capture. |
format | string | optional | png | png or jpeg. Defaults to png. |
quality | integer | optional | 85 | JPEG quality, 40-100. Ignored for png. |
blockAds | boolean | optional | true | Drop known ad and tracker hosts before they render. |
hideOverlays | boolean | optional | false | Remove cookie banners, newsletter modals and large sticky panels after load. |
Output
| Field | Type | Description |
|---|---|---|
fileBase64 | string | Captured image, base64-encoded, without a data URI prefix. |
mimeType | string | image/png or image/jpeg. |
width | integer | Pixel width of the returned image. |
height | integer | Pixel height of the returned image. |
pageTitle | string | Document title, useful as a filename. |
finalUrl | string | Address after any redirects. |
truncated | boolean | True when a very tall page was clipped to the height ceiling. |
blockedRequestCount | integer | Requests dropped as ads, trackers or private-network targets. |
Try it
Sends a real POST /api/v1/tools/website-screenshot from your browser and charges 25 credits to your account.
Sign in to run this endpoint. New accounts start with free credits.