Resumen de la API

• Endpoint: POST https://api.cofferdock.com/screenshot
• Auth: cabecera x-api-key: TU_LLAVE.
• Entrada: la URL va en el cuerpo como text/plain (a pelo) o como application/json en el campo url.
• Salida: por defecto, con text/plain devuelve el binario de la imagen (image/png o image/jpeg); con JSON devuelve base64. Añade output=image para forzar el binario.
• Seguridad: solo URLs públicas http/https; las IPs internas/privadas se bloquean (anti-SSRF). El JavaScript de la web SÍ se ejecuta, en un contexto efímero y aislado.
• Límites: timeout 30 s; 30 capturas/min por IP. 1 captura = 1 crédito.

Opciones

Ejemplos

curl (URL a pelo, guarda la imagen en un fichero):

curl -X POST "https://api.cofferdock.com/screenshot?width=1280&height=800" \
  -H "x-api-key: TU_LLAVE" \
  -H "Content-Type: text/plain" \
  --data "https://cofferdock.com" \
  -o captura.png

JavaScript (Node 18+):

const r = await fetch('https://api.cofferdock.com/screenshot?width=1280&height=800', {
  method: 'POST',
  headers: { 'x-api-key': 'TU_LLAVE', 'Content-Type': 'text/plain' },
  body: 'https://cofferdock.com',
});
const buffer = Buffer.from(await r.arrayBuffer());
require('fs').writeFileSync('captura.png', buffer);

Python:

import requests
r = requests.post(
    'https://api.cofferdock.com/screenshot',
    params={'width': 1280, 'height': 800},
    headers={'x-api-key': 'TU_LLAVE', 'Content-Type': 'text/plain'},
    data='https://cofferdock.com',
)
open('captura.png', 'wb').write(r.content)

Modo JSON (respuesta en base64)

Con Content-Type: application/json, la URL va en url y las opciones en el mismo objeto. La respuesta trae la imagen en base64:

{ "url": "https://cofferdock.com", "width": 1280, "full_page": true }
→ { "success": true, "image": "iVBORw0KGgo…", "mime_type": "image/png",
    "meta": { "used": 12, "remaining": 488, "size_bytes": 95421 } }

Añade "output": "image" al JSON para recibir el binario en lugar del base64.

API overview

• Endpoint: POST https://api.cofferdock.com/screenshot
• Auth: header x-api-key: YOUR_KEY.
• Input: the URL goes in the body as text/plain (raw) or as application/json in the url field.
• Output: by default, with text/plain it returns the image binary (image/png or image/jpeg); with JSON it returns base64. Add output=image to force the binary.
• Security: public http/https URLs only; internal/private IPs are blocked (anti-SSRF). The page's JavaScript DOES run, in an ephemeral, isolated context.
• Limits: 30 s timeout; 30 screenshots/min per IP. 1 screenshot = 1 credit.

Options

Examples

curl (raw URL, saves the image to a file):

curl -X POST "https://api.cofferdock.com/screenshot?width=1280&height=800" \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: text/plain" \
  --data "https://cofferdock.com" \
  -o screenshot.png

JavaScript (Node 18+):

const r = await fetch('https://api.cofferdock.com/screenshot?width=1280&height=800', {
  method: 'POST',
  headers: { 'x-api-key': 'YOUR_KEY', 'Content-Type': 'text/plain' },
  body: 'https://cofferdock.com',
});
const buffer = Buffer.from(await r.arrayBuffer());
require('fs').writeFileSync('screenshot.png', buffer);

Python:

import requests
r = requests.post(
    'https://api.cofferdock.com/screenshot',
    params={'width': 1280, 'height': 800},
    headers={'x-api-key': 'YOUR_KEY', 'Content-Type': 'text/plain'},
    data='https://cofferdock.com',
)
open('screenshot.png', 'wb').write(r.content)

JSON mode (base64 response)

With Content-Type: application/json, the URL goes in url and the options in the same object. The response carries the image in base64:

{ "url": "https://cofferdock.com", "width": 1280, "full_page": true }
→ { "success": true, "image": "iVBORw0KGgo…", "mime_type": "image/png",
    "meta": { "used": 12, "remaining": 488, "size_bytes": 95421 } }

Add "output": "image" to the JSON to receive the binary instead of base64.