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

URL: https://blog.relayted.de/screenshot-api-real-browsers/
Published: 2026-11-14
Updated: 2026-11-16
Service: relayted shots

## 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](https://api.relayted.de/account)) and a small balance, this call orders six screenshots: three browsers, one laptop viewport, light and dark mode.

```bash
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:

```bash
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. Default `1920x1080`.
- **schemes**: `light`, `dark` or both. Each scheme is its own screenshot, so you see how the page reacts to `prefers-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](https://api.relayted.de/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](https://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.
