relayted blog

Guide

Screenshot API without a subscription: real Chrome, Firefox and Safari (WebKit)

shotsPublished Updated 3 min read
Screenshot API without a subscription: real Chrome, Firefox and Safari (WebKit)

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:

IdEngineKind
chromeChromiumDesktop, current and previous versions
edgeChromiumDesktop, current and previous versions
firefoxGeckoDesktop, current and previous versions
safariWebKitDesktop, current and previous versions
braveChromiumDesktop
operaChromiumDesktop
iphone-safariWebKitMobile profile with its own screen size
ipad-safariWebKitMobile profile with its own screen size
android-chromeChromiumMobile 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

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 jobPrice each
1st to 12th65 Payloads
from the 13th40 Payloads

10,000 Payloads are 1 EUR; the live numbers are in /v1/pricing.

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.