Skip to content
curl tutorial api quickstart

cURL : démarrage rapide avec l’API Screenshot

Une commande pour lancer la capture, puis pays, appareil, PDF, étapes d’automatisation et boucle jq — liens vers la référence API.

Julien Sobrier Fondateur et CEO

La commande minimale

export SCREENSHOTCENTER_API_KEY="VOTRE_CLE"
curl -sS "https://api.screenshotcenter.com/api/v1/screenshot/create?key=${SCREENSHOTCENTER_API_KEY}&url=https://example.com" | jq .

La réponse JSON contient data.id et data.status. Tant que le statut vaut processing, appelez /screenshot/info. Une fois finished, récupérez le PNG via /screenshot/thumbnail ou le PDF via /screenshot/pdf si vous aviez passé pdf=true. Liste exhaustive des paramètres : référence API ; guides : Developers.

Télécharger le PNG

ID=12345678
curl -fS "https://api.screenshotcenter.com/api/v1/screenshot/thumbnail?key=${SCREENSHOTCENTER_API_KEY}&id=${ID}" -o capture.png

Pays et appareil

curl -sS "https://api.screenshotcenter.com/api/v1/screenshot/create?key=${SCREENSHOTCENTER_API_KEY}&url=https://example.com&country=de" | jq .
curl -sS "https://api.screenshotcenter.com/api/v1/screenshot/create?key=${SCREENSHOTCENTER_API_KEY}&url=https://example.com&device_name=iphone_15_pro" | jq .

PDF

curl -sS "https://api.screenshotcenter.com/api/v1/screenshot/create?key=${SCREENSHOTCENTER_API_KEY}&url=https://example.com&pdf=true&pdf_format=a4&pdf_background=true" | jq .data.id
curl -fS "https://api.screenshotcenter.com/api/v1/screenshot/pdf?key=${SCREENSHOTCENTER_API_KEY}&id=${ID}" -o page.pdf

Automatisation (step[])

curl -sS -G "https://api.screenshotcenter.com/api/v1/screenshot/create" \
  --data-urlencode "key=${SCREENSHOTCENTER_API_KEY}" \
  --data-urlencode "url=https://example.com/login" \
  --data-urlencode "step[0][command]=type" \
  --data-urlencode "step[0][element]=input[name=email]" \
  --data-urlencode "step[0][value]=vous@exemple.com" \
  --data-urlencode "step[1][command]=click" \
  --data-urlencode "step[1][element]=button[type=submit]" \
  --data-urlencode "step[2][command]=sleep" \
  --data-urlencode "step[2][value]=2000" \
  --data-urlencode "step[3][command]=screenshot" | jq .

Approfondissez les sélecteurs sur la page Automation.

Aide-mémoire jq

BesoinCommande
JSON lisible| jq .
Identifiant brut| jq -r .data.id
Statut| jq -r .data.status

Boucle bash

ID=$(curl -sS "https://api.screenshotcenter.com/api/v1/screenshot/create?key=${SCREENSHOTCENTER_API_KEY}&url=https://example.com" | jq -r .data.id)
while true; do
  ST=$(curl -sS "https://api.screenshotcenter.com/api/v1/screenshot/info?key=${SCREENSHOTCENTER_API_KEY}&id=${ID}" | jq -r .data.status)
  [[ "$ST" == "finished" ]] && break
  [[ "$ST" == "error" ]] && exit 1
  sleep 2
done
curl -fS "https://api.screenshotcenter.com/api/v1/screenshot/thumbnail?key=${SCREENSHOTCENTER_API_KEY}&id=${ID}" -o capture.png