Storage Integration

S3-compatible Storage

Send screenshot images, PDFs, and video outputs to any S3-compatible object store using an access key and secret. Works with AWS S3, Cloudflare R2, Wasabi, MinIO, Backblaze B2, and any other S3-API endpoint.

This page

S3-compatible — Key / Secret

Works with any S3-compatible endpoint using an access key and secret. Ideal for Cloudflare R2, Wasabi, MinIO, or any self-hosted store.

Also available

AWS S3 — Cross-account

Grant ScreenshotCenter write access to your AWS S3 bucket via ACL — no credentials to store or rotate.

Compatible providers

AWS S3

Cloudflare R2

Wasabi

MinIO

Backblaze B2

DigitalOcean Spaces

Linode Object Storage

Scaleway Object Storage

Self-hosted (MinIO, Ceph…)

How it works

1

Create an access key with write permissions

In your storage provider's console, create an access key scoped to write access on a specific bucket. Never use root or admin credentials.
2

Add the S3 app in ScreenshotCenter

Go to Apps → Connect a new app → S3-compatible. Enter your endpoint URL, bucket name, region, access key, and secret. Set an optional path template.
3

Use the app ID in your requests

Add the app ID to the apps parameter. The object URL is returned in apps[].output_url.

Quick start

curl "https://api.screenshotcenter.com/api/v1/screenshot/create\
  ?key=YOUR_API_KEY\
  &url=https://example.com\
  &apps=my-s3-app"

import { ScreenshotCenterClient } from 'screenshotcenter';

const client = new ScreenshotCenterClient(process.env.SCREENSHOTCENTER_API_KEY);

const shot = await client.screenshot.create('https://example.com', {
  apps: ['my-s3-app'],
});

console.log(shot.apps[0].output_url); // S3 object URL

from screenshotcenter import ScreenshotCenterClient

client = ScreenshotCenterClient(api_key="YOUR_API_KEY")

shot = client.screenshot.create(
    "https://example.com",
    apps=["my-s3-app"],
)

print(shot["apps"][0]["output_url"])  # S3 object URL

use ScreenshotCenter\Client;

$client = new Client(getenv('SCREENSHOTCENTER_API_KEY'));

$shot = $client->screenshot->create('https://example.com', [
    'apps' => ['my-s3-app'],
]);

echo $shot['apps'][0]['output_url']; // S3 object URL

import (
    "fmt"
    sc "github.com/juliensobrier/screenshotcenter-go"
)

client := sc.New("YOUR_API_KEY")

shot, _ := client.Screenshot.Create("https://example.com", &sc.ScreenshotParams{
    Apps: []string{"my-s3-app"},
})

fmt.Println(shot.Apps[0].OutputURL) // S3 object URL

require "screenshotcenter"

client = ScreenshotCenter::Client.new(ENV["SCREENSHOTCENTER_API_KEY"])

shot = client.screenshot.create("https://example.com",
  apps: ["my-s3-app"],
)

puts shot["apps"][0]["output_url"] # S3 object URL

import io.screenshotcenter.ScreenshotCenterClient;
import io.screenshotcenter.models.*;
import java.util.List;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = new ScreenshotCenterClient("YOUR_API_KEY");

        var shot = client.screenshot().create("https://example.com",
            new ScreenshotParams().apps(List.of("my-s3-app")));

        System.out.println(shot.getApps().get(0).getOutputUrl()); // S3 URL
    }
}

using ScreenshotCenter;

var client = new ScreenshotCenterClient("YOUR_API_KEY");

var shot = await client.Screenshot.CreateAsync("https://example.com", new ScreenshotParams {
    Apps = new[] { "my-s3-app" },
});

Console.WriteLine(shot.Apps[0].OutputUrl); // S3 object URL

The uploaded object URL is returned in apps[].output_url once the job finishes.

Custom file paths

Use a path template to control how objects are named and organised inside the bucket:

screenshots/{domain}/{yyyy}{mm}{dd}-{id}.png

Available variables: {id}, {domain}, {yyyy}, {mm}, {dd}, {shot}, {browser}, {country}.

Get started

1. Create a bucket and an access key with write permissions on your S3-compatible provider.
2. In ScreenshotCenter, go to Apps → Connect a new app → S3-compatible.
3. Enter your endpoint, bucket, region, access key, and secret. Set an optional path template and save.
4. Add the app ID to the apps parameter in your screenshot requests.

Get started free AWS S3 cross-account API reference