Short answer
Send the URL, a list of browsers, viewports and colour schemes to POST /v1/shots/jobs on api.relayted.de and you get one PNG per browser version, viewport and scheme, rendered in real engines (Chrome, Edge, Firefox, Safari/WebKit, Brave, Opera) plus iPhone, iPad and Android profiles. Screenshots 1 to 12 of a job cost 65 Payloads each, from the 13th on 40 Payloads (10,000 Payloads = 1 EUR); there is no subscription.
The minimal request
With an API key (created once at api.relayted.de/account) and a small balance, this call orders six screenshots: three browsers, one laptop viewport, light and dark mode.
export RELAYTED_KEY="RAPI-XXXX-XXXX-XXXX-XXXX-XXXX"
curl -s "https://api.relayted.de/v1/shots/jobs?wait=25" \
-H "Authorization: Bearer $RELAYTED_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com",
"browsers":["chrome","firefox","safari"],
"viewports":["laptop"],
"schemes":["light","dark"],
"options":{"fullPage":true,"hideCookieBanner":true}}' > job.json
jq '.job | {id, status, cost}' job.json
Real browsers need a few seconds per screenshot (roughly 5 to 10), so a job is often still processing after the first call. Poll until it is done, then fetch everything as one ZIP:
JOB=$(jq -r '.job.id' job.json)
while :; do
STATUS=$(curl -s "https://api.relayted.de/v1/jobs/$JOB?wait=25" \
-H "Authorization: Bearer $RELAYTED_KEY" | jq -r '.job.status')
[ "$STATUS" = completed ] || [ "$STATUS" = failed ] && break
done
curl -s "https://api.relayted.de/v1/jobs/$JOB/zip" \
-H "Authorization: Bearer $RELAYTED_KEY" -o screenshots.zip
Single files are available too: every entry in job.results has a key (the file name) and, once it is done, a download url. Add ?thumb=1 to a result URL for a small WebP preview.
Which browsers and devices
The catalogue is public: GET https://api.relayted.de/v1/services/shots lists all ids and versions, no key needed. At the time of writing it contains:
| Id | Engine | Kind |
|---|---|---|
chrome | Chromium | Desktop, current and previous versions |
edge | Chromium | Desktop, current and previous versions |
firefox | Gecko | Desktop, current and previous versions |
safari | WebKit | Desktop, current and previous versions |
brave | Chromium | Desktop |
opera | Chromium | Desktop |
iphone-safari | WebKit | Mobile profile with its own screen size |
ipad-safari | WebKit | Mobile profile with its own screen size |
android-chrome | Chromium | Mobile profile with its own screen size |
A browser given as a string means its newest version. To pick versions, pass an object: {"id":"chrome","versions":["155"]}, using the version numbers from the catalogue.
Viewports, dark mode and other options
- viewports apply to desktop browsers:
"WIDTHxHEIGHT", an object{"w":1280,"h":800}or a preset:fhd(1920×1080),qhd(2560×1440),laptop(1440×900),hd(1366×768),tablet(820×1180),phone(390×844). Width 320 to 3840, height 320 to 2400. Default1920x1080. - schemes:
light,darkor both. Each scheme is its own screenshot, so you see how the page reacts toprefers-color-scheme. - options.fullPage: the whole page instead of the visible area.
- options.retina: device pixel ratio 2.
- options.hideCookieBanner: tries to hide common consent banners.
- options.delay: wait 0, 2 or 5 seconds after load, for pages that animate in.
Mobile profiles ignore the viewports and use their device screen.
How many screenshots a job makes
Desktop browsers produce versions × viewports × schemes screenshots, mobile profiles versions × schemes. A job can contain up to 200 screenshots. The example above makes 3 × 1 × 2 = 6.
What it costs
| Screenshots in one job | Price each |
|---|---|
| 1st to 12th | 65 Payloads |
| from the 13th | 40 Payloads |
10,000 Payloads are 1 EUR; the live numbers are in /v1/pricing.
- The example above: 6 × 65 = 390 Payloads, about 4 cent.
- A release check with 15 screenshots: 12 × 65 + 3 × 40 = 900 Payloads, 9 cent.
POST /v1/shots/quote with the same body is free and lists every single screenshot with its price. The URL is probed before anything is charged, and every screenshot that fails is refunded; the ZIP contains only the finished ones.
Privacy and retention
Screenshots and the target URL are deleted 24 hours after the job was created. The balance is prepaid, and the API key is not tied to a name or e-mail address unless you store a billing address for invoices.
Without code
The same screenshots are available in a web interface at shots.relayted.de, paid with Lightning. Use the API when screenshots belong into a script, a deployment step or an agent.
FAQ
Which browsers are available?
Desktop Chrome, Edge, Firefox, Safari (WebKit), Brave and Opera, each in the current and previous versions, plus iPhone Safari, iPad Safari and Android Chrome profiles. GET https://api.relayted.de/v1/services/shots lists the exact ids and versions without a key.
How much does a screenshot cost?
65 Payloads for each of the first 12 screenshots of a job and 40 Payloads from the 13th on. 10,000 Payloads are 1 EUR. A free quote (POST /v1/shots/quote) shows the price of every single screenshot before you pay.
Can I take full-page and dark-mode screenshots?
Yes. Set options.fullPage to true and add "dark" to schemes. Each scheme produces its own screenshot.
How do I get all screenshots at once?
When the job is completed, GET /v1/jobs/<id>/zip returns all finished screenshots as one ZIP file.
How long are screenshots kept?
Screenshots and the target URL are deleted 24 hours after the job was created.
