API de captura de pantalla web — captura cualquier URL como imagen o PDF
Envía una URL pública y obtén de vuelta una PNG, JPEG, WebP o PDF de la página — el viewport visible o la altura de desplazamiento completa, hasta 3× para pantallas retina. Sin granja de navegadores que ejecutar, sin cola que mantener.
100 renders / mes gratis · sin tarjeta · planes pagados nunca son bloqueadosCómo funciona
Envía la URL
POST la dirección de la página a /v1/screenshots con el viewport que deseas — 1200 × 630 por defecto, hasta 2400 píxeles en cada dirección.
Elige la captura
Establece fullPage para toda la altura de desplazamiento, scale para una salida más nítida, u output "pdf" con un tamaño de papel como A4 o Letter para un documento paginado.
Obtén el archivo de vuelta
La respuesta contiene una URL a la imagen o PDF almacenada. Para páginas lentas, envía async: true o un webhookUrl y te llamaremos cuando esté lista.
Una llamada a API
curl https://api.mostlyrender.com/v1/screenshots \
-H "Authorization: Bearer mr_test_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com","fullPage":true,"output":"png"}'Preguntas
¿Cuánto cuesta una captura de pantalla web?
Una captura de pantalla es un render en tu plan. El plan Free incluye 100 renders al mes; Starter es $19 por 2,000, Pro $49 por 10,000 y Scale $149 por 50,000. Después de eso, los planes pagados facturan excedentes a $3–$5 por 1,000 en lugar de bloquear tus capturas.
¿Puedo capturar la página completa, no solo el viewport?
Sí. Establece fullPage: true y la captura cubre toda la altura de desplazamiento de la página. width y height establecen el viewport (1200 × 630 por defecto, hasta 2400 píxeles cada uno), y scale hasta 3 para renders con una relación de píxel de dispositivo más alta para salida retina.
¿Puedo guardar una página web como PDF?
Sí. Establece output como pdf. Sin un tamaño de papel obtienes una captura de altura completa; agrega papel — A4, A3, A5, Letter, Legal, Tabloid o Ledger — y la página se pagina en un documento con márgenes.
¿Cuáles URLs puedo capturar?
Cualquier dirección http o https pública. Las direcciones privadas, internas y de metadatos en la nube se rechazan, incluido cuando una URL pública redirige a una, por lo que la API no puede apuntarse a tu red interna. Las páginas que requieren inicio de sesión no son compatibles.
¿Puedo tomar capturas de pantalla de forma asincrónica?
Sí. Agrega async: true y la API responde 202 con un id de trabajo de inmediato. Agrega un webhookUrl para recibir una devolución de llamada firmada cuando la captura esté lista, o notifyEmail para recibir un correo.
¿Se cachean las capturas repetidas?
No. Cada llamada captura la página tal como está en ese momento y cuenta como un render — lo que quieres para monitoreo y archivo. Las imágenes construidas a partir de tus propios datos con plantillas y URLs firmadas se cachean y no se facturan de nuevo.
¿Oculta banners de cookies o bloquea anuncios?
No. La captura muestra la página tal como la ve un visitante por primera vez, incluido el banner de cookies. Para una imagen limpia, captura una página que controlas o renderizia tu contenido desde una plantilla en su lugar.