API Screenshots

Deux modes disponibles selon votre usage. Dans les deux cas, il vous faut une clé API.

Les captures sont facturées à la création ou mise à jour. L'affichage d'une capture existante est gratuit et non limité.

Mode Hébergé (APIv1)

Les captures sont générées et hébergées sur les serveurs Shotbot. Vous pointez simplement vers notre URL.

Idéal pour : annuaires, sites partenaires, volumes inférieurs à 50 000 captures/mois.

Demander une capture

HTTP GET

https://add.shotbot.net/k={VOTRE_CLÉ}/url={URL_ENCODÉE}

Afficher la capture

HTML

<img src="https://img.shotbot.net/{MD5_URL}/120.jpg"
     width="120" height="90" alt="Screenshot">

Formats disponibles

Fichier	Dimensions	Usage
`320.jpg`	320×240	Aperçu large
`240.jpg`	240×180	Vignette moyenne
`160.jpg`	160×120	Vignette standard
`120.jpg`	120×90	Ascreen / thumb
`92.jpg`	92×69	Miniature
`80.jpg`	80×60	Icône

Codes de retour

Code	Signification
OK	Capture créée ou mise en queue avec succès
OK waitlist	Quota mensuel dépassé — requête en file d'attente
ERR key	Clé API invalide ou absente
ERR args	Paramètres incorrects
ERR url	URL non valide ou inaccessible

Exemple PHP complet

PHP

<?php
$api_key = "VOTRE_CLÉ_API";
$url     = "https://example.com";

// Demande de capture
$endpoint = "https://add.shotbot.net/k=" . $api_key . "/url=" . urlencode($url);
$result   = file_get_contents($endpoint); // "OK" ou "ERR ..."

// Affichage (disponible après ~20 secondes)
$md5  = md5($url);
$img  = "https://img.shotbot.net/" . $md5[0] . "/" . substr($md5,0,2) . "/" . $md5 . "/120.jpg";
echo "<img src=\"$img\" width=\"120\" height=\"90\">";

Désactiver JavaScript

Certains sites affichent des disclaimers ou pop-ups bloquants en JS. Ajoutez /nojs/1 au chemin :

HTTP GET

https://add.shotbot.net/k={CLÉ}/nojs/1/url={URL}

Mode Callback (Marque blanche)

Shotbot génère la capture et la pousse vers votre serveur via une requête HTTP POST. Aucun hébergement de notre côté — les images atterrissent directement chez vous.

Idéal pour : sites à fort volume, revendeurs, white-label, hébergement multi-tenant.

Ce mode est réservé aux développeurs. L'intégration côté serveur est entièrement à votre charge.

Demande de capture (POST)

HTTP POST → agent.shotbot.net

POST https://agent.shotbot.net/job/
Content-Type: application/x-www-form-urlencoded

k={CLÉ}&url={URL_ENCODÉE}&callback={URL_CALLBACK_ENCODÉE}&sizes=120,320

Réception (votre serveur)

Shotbot envoie un POST à votre callback_url avec les champs suivants :

POST reçu (multipart/form-data)

url       = URL originale capturée
md5       = MD5 de l'URL
status    = OK | ERR
file_120  = image JPEG 120×90 (binaire)
file_320  = image JPEG 320×240 (binaire)
# etc. selon les tailles demandées

Exemple de handler PHP

PHP (votre serveur)

<?php
// callback.php — reçoit la capture de Shotbot
if ($_POST['status'] !== 'OK') { http_response_code(200); exit; }

$md5  = preg_replace('/[^a-f0-9]/', '', $_POST['md5']);
$dest = __DIR__ . '/shots/' . $md5 . '_120.jpg';

if (isset($_FILES['file_120'])) {
    move_uploaded_file($_FILES['file_120']['tmp_name'], $dest);
}
http_response_code(200);
echo 'OK';

Format Ascreen

Le format Ascreen permet à votre site d'apparaître avec une capture d'écran dans les annuaires et moteurs compatibles. Il suffit de placer un fichier JPEG nommé ascreen.jpg (120×90 px) à la racine de votre domaine.

URL type

https://votre-site.com/ascreen.jpg

Shotbot peut générer et mettre à jour ce fichier directement via l'API si votre hébergeur le permet, ou vous pouvez le récupérer depuis notre CDN et le déposer vous-même.

Obtenir une clé API Créer un compte gratuit