Captura de webs

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.