Storage Integration

FTP / SFTP

Transfer screenshot images, PDF reports, and video captures to any FTP or SFTP server after every job. Integrate ScreenshotCenter with legacy systems, hosting environments, and custom data pipelines that rely on FTP-based delivery.

Recommended

SFTP (SSH File Transfer)

Transfers are encrypted over SSH. Use password or SSH key authentication for maximum security.

Also supported

FTP / FTPS

Classic FTP with optional TLS (FTPS). Use for legacy server environments that don't support SSH.

How it works

1

Create an FTP/SFTP user with write access

On your server, create a dedicated FTP or SFTP user scoped to a specific directory. Use a strong password or SSH key pair. Never use root credentials.
2

Add the FTP app in ScreenshotCenter

Go to Apps → Connect a new app → FTP. Enter your server host, port, username, password (or private key for SFTP), and the remote destination directory.
3

Configure a path template

Set a path template to control how files are named and placed on the server. Remote directories are created automatically if they don't exist.
4

Include the app ID in screenshot requests

Add the FTP app ID to the apps parameter. ScreenshotCenter transfers the file after the capture completes.

Quick start

curl "https://api.screenshotcenter.com/api/v1/screenshot/create\
  ?key=YOUR_API_KEY\
  &url=https://example.com\
  &apps=my-ftp-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-ftp-app'],
});

console.log(shot.apps[0].status); // "finished"

from screenshotcenter import ScreenshotCenterClient

client = ScreenshotCenterClient(api_key="YOUR_API_KEY")

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

print(shot["apps"][0]["status"])  # "finished"

use ScreenshotCenter\Client;

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

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

echo $shot['apps'][0]['status']; // "finished"

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-ftp-app"},
})

fmt.Println(shot.Apps[0].Status) // "finished"

require "screenshotcenter"

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

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

puts shot["apps"][0]["status"] # "finished"

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-ftp-app")));

        System.out.println(shot.getApps().get(0).getStatus()); // "finished"
    }
}

using ScreenshotCenter;

var client = new ScreenshotCenterClient("YOUR_API_KEY");

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

Console.WriteLine(shot.Apps[0].Status); // "finished"

The transfer status is reflected in apps[].status once the job completes.

Remote path templates

Control how files are placed on the remote server:

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

Available variables: {id}, {domain}, {yyyy}, {mm}, {dd}, {shot}, {browser}, {country}. Missing directories are created automatically.

Use cases

Legacy system integration

Feed screenshots into downstream systems that ingest files via FTP — publishing tools, archival software, and legacy content management systems.

Web hosting delivery

Transfer captures directly to your web server document root and serve them as static assets — no cloud storage required.

Offline and air-gapped environments

Deliver screenshots to servers in restricted networks that can't access cloud storage but expose an SFTP endpoint.

Custom media pipelines

Drop images and videos into FTP directories watched by media processing workflows — transcoding queues, CDN upload scripts, and batch image processors.

Get started

1. Create a dedicated FTP/SFTP user with write access to a specific directory on your server.
2. In ScreenshotCenter, go to Apps → Connect a new app → FTP.
3. Enter host, port, username, credentials, remote directory, and path template. Test the connection and save.
4. Add the app ID to the apps parameter in your screenshot requests.

Get started free API reference All integrations