API d’automatisation

Automatisation de page avant la capture

Automatisez les interactions — clic, saisie, défilement et attente — avant la capture. Gérez les pages derrière connexion, fermez les bannières de consentement, enchaînez les états JavaScript et les parcours multi-commandes.

Commandes

Utilisez des commandes comme click, type, wait et screenshot avec des sélecteurs target optionnels.

Pop-ups et cookies

hide_popups=true applique des règles anti-bannière pour centrer la capture sur le contenu.

Réduction de la publicité

hide_ads=true limite le bruit publicitaire pour la régression visuelle et la surveillance.

Preuve vidéo

video=true enregistre tout le flux d’interaction en mp4, webm ou gif.

Exemple en direct

Se connecter au site, puis capturer

L’automatisation remplit le formulaire de connexion, l’envoie, attend le tableau de bord puis prend la capture — le tout piloté par le paramètre steps.

Exemple en direct

Interagir avec des éléments dynamiques

Info-bulles de graphiques, recherches, arbres dépliables, tiroirs — tout comme un utilisateur réel. Capturez l’état exact souhaité, pas seulement le chargement initial.

Exemple de code

Exécutez des commandes d’automatisation dans votre langage

Chaque SDK prend en charge le paramètre steps. Soumettez le job, interrogez le statut ou utilisez un webhook pour récupérer le résultat.

# Exemple : commandes avant capture (connexion) + vidéo MP4
curl -X POST https://api.screenshotcenter.com/v1/screenshot \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/dashboard",
    "country": "us",
    "steps": [
      { "command": "click",      "selector": "#login-btn" },
      { "command": "type",       "selector": "#email",    "value": "user@example.com" },
      { "command": "type",       "selector": "#password", "value": "secret" },
      { "command": "click",      "selector": "button[type=submit]" },
      { "command": "wait",       "value": 1500 },
      { "command": "screenshot", "target": ".dashboard" }
    ],
    "hide_popups": true,
    "hide_ads": true,
    "video": true,
    "video_format": "mp4"
  }'

// Client avec commandes, masquage pop-up / pubs et vidéo MP4
import { ScreenshotCenterClient } from 'screenshotcenter';

const client = new ScreenshotCenterClient({ apiKey: 'YOUR_API_KEY' });

const screenshot = await client.screenshot.create({
  url: 'https://example.com/dashboard',
  country: 'us',
  steps: [
    { command: 'click',      selector: '#login-btn' },
    { command: 'type',       selector: '#email',    value: 'user@example.com' },
    { command: 'type',       selector: '#password', value: 'secret' },
    { command: 'click',      selector: 'button[type=submit]' },
    { command: 'wait',       value: 1500 },
    { command: 'screenshot', target: '.dashboard' },
  ],
  hide_popups: true,
  hide_ads: true,
  video: true,
  video_format: 'mp4',
});

const result = await client.waitFor(screenshot.id);
console.log(result.screenshot_url);

# Même scénario : commandes, hide_popups, hide_ads, vidéo
from screenshotcenter import ScreenshotCenterClient

client = ScreenshotCenterClient(api_key="YOUR_API_KEY")

shot = client.screenshot.create(
    url="https://example.com/dashboard",
    country="us",
    steps=[
        {"command": "click",      "selector": "#login-btn"},
        {"command": "type",       "selector": "#email",    "value": "user@example.com"},
        {"command": "type",       "selector": "#password", "value": "secret"},
        {"command": "click",      "selector": "button[type=submit]"},
        {"command": "wait",       "value": 1500},
        {"command": "screenshot", "target": ".dashboard"},
    ],
    hide_popups=True,
    hide_ads=True,
    video=True,
    video_format="mp4",
)

result = client.wait_for(shot["id"])
print(result["screenshot_url"])

// PHP : commandes d'automatisation et sortie vidéo
use ScreenshotCenter\Client;

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

$shot = $client->screenshot->create('https://example.com/dashboard', [
    'country'      => 'us',
    'steps'        => [
        ['command' => 'click',      'selector' => '#login-btn'],
        ['command' => 'type',       'selector' => '#email',    'value' => 'user@example.com'],
        ['command' => 'type',       'selector' => '#password', 'value' => 'secret'],
        ['command' => 'click',      'selector' => 'button[type=submit]'],
        ['command' => 'wait',       'value'    => 1500],
        ['command' => 'screenshot', 'target'   => '.dashboard'],
    ],
    'hide_popups'  => true,
    'hide_ads'     => true,
    'video'        => true,
    'video_format' => 'mp4',
]);

$result = $client->waitFor($shot['id']);
echo $result['screenshot_url'];

// Go : commandes, options vidéo et attente du résultat
import sc "github.com/juliensobrier/screenshotcenter-go"

client := sc.New("YOUR_API_KEY")

videoTrue := true
shot, err := client.Screenshot.Create("https://example.com/dashboard", &sc.CreateParams{
    Country: "us",
    Steps: []sc.Step{
        {Command: "click",      Selector: "#login-btn"},
        {Command: "type",       Selector: "#email",    Value: "user@example.com"},
        {Command: "type",       Selector: "#password", Value: "secret"},
        {Command: "click",      Selector: "button[type=submit]"},
        {Command: "wait",       Value: "1500"},
        {Command: "screenshot", Target: ".dashboard"},
    },
    HidePopups:   true,
    HideAds:      true,
    Video:        &videoTrue,
    VideoFormat:  "mp4",
})
if err != nil { log.Fatal(err) }

result, _ := client.WaitFor(shot.ID, nil)
fmt.Println(result.ScreenshotURL)

# Ruby : enchaînement d'actionspuis wait_for
require "screenshotcenter"

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

shot = client.screenshot.create("https://example.com/dashboard",
  country: "us",
  steps: [
    { command: "click",      selector: "#login-btn" },
    { command: "type",       selector: "#email",    value: "user@example.com" },
    { command: "type",       selector: "#password", value: "secret" },
    { command: "click",      selector: "button[type=submit]" },
    { command: "wait",       value: 1500 },
    { command: "screenshot", target: ".dashboard" },
  ],
  hide_popups: true,
  hide_ads: true,
  video: true,
  video_format: "mp4"
)

result = client.wait_for(shot["id"])
puts result["screenshot_url"]

// Java : liste de commandes et paramètres vidéo
import com.screenshotcenter.ScreenshotCenterClient;
import java.util.*;

ScreenshotCenterClient client = new ScreenshotCenterClient("YOUR_API_KEY");

var steps = List.of(
    Map.of("command", "click",      "selector", "#login-btn"),
    Map.of("command", "type",       "selector", "#email",    "value", "user@example.com"),
    Map.of("command", "type",       "selector", "#password", "value", "secret"),
    Map.of("command", "click",      "selector", "button[type=submit]"),
    Map.of("command", "wait",       "value",    "1500"),
    Map.of("command", "screenshot", "target",   ".dashboard")
);
var params = Map.of(
    "country",      "us",
    "steps",        steps,
    "hide_popups",  "true",
    "hide_ads",     "true",
    "video",        "true",
    "video_format", "mp4"
);
var shot   = client.screenshot().create("https://example.com/dashboard", params);
var result = client.waitFor(shot.getLong("id"), null, null);
System.out.println(result.getString("screenshot_url"));

// C# : tâche asynchrone avec commandes et vidéo
using ScreenshotCenter;

var client = new ScreenshotCenterClient("YOUR_API_KEY");

var shot = await client.Screenshot.CreateAsync("https://example.com/dashboard",
    new Dictionary<string, object> {
        ["country"]      = "us",
        ["steps"]        = new[] {
            new { command = "click",      selector = "#login-btn" },
            new { command = "type",       selector = "#email",    value = "user@example.com" },
            new { command = "type",       selector = "#password", value = "secret" },
            new { command = "click",      selector = "button[type=submit]" },
            new { command = "wait",       value    = 1500 },
            new { command = "screenshot", target   = ".dashboard" },
        },
        ["hide_popups"]  = true,
        ["hide_ads"]     = true,
        ["video"]        = true,
        ["video_format"] = "mp4",
    });

var result = await client.WaitForAsync(shot.Id);
Console.WriteLine(result.ScreenshotUrl);

Toute la doc des SDK →Référence API complète →

Questions fréquentes

Quelles commandes d’automatisation sont prises en charge ?

Clic, saisie, défilement, attente, navigation, liste déroulante, survol et capture. Les commandes s’enchaînent dans un vrai Chrome avant la capture finale.

Puis-je me connecter avant de capturer ?

Oui. Enchaînez clics et saisie pour le formulaire de connexion, attendez le tableau de bord, puis capturez. Vous pouvez aussi injecter des cookies de session.

Comment fermer les bannières de cookies ?

Utilisez hide_popups=true pour les règles intégrées, ou une action click sur le bouton de fermeture.

Puis-je enregistrer une vidéo du scénario ?

Oui. video=true enregistre tout le flux en MP4, WebM ou GIF — utile pour rapports, QA et conformité.