API de Conversión de Archivos EnConvert#

EnConvert es una API REST de conversión de archivos para convertir documentos, imágenes, formatos de datos y páginas web entre formatos. Por ejemplo, convierte una URL en un PDF mediante /v1/convert/url-to-pdf. Ofrece a los desarrolladores acceso programático a 51 endpoints de conversión más seis endpoints de inteligencia web V2, sin necesidad de gestionar infraestructura de conversión. Las solicitudes se ejecutan en modo síncrono o asíncrono, y el procesamiento por lotes convierte varios archivos o URLs en una sola solicitud.

Beta: La API de EnConvert se encuentra actualmente en beta. Los endpoints, parámetros y formatos de respuesta pueden cambiar a medida que refinamos la plataforma según los comentarios de los desarrolladores. Recomendamos fijar el comportamiento específico en lugar de depender de campos no documentados.

URL base:

https://api.enconvert.com

Todas las solicitudes a la API deben realizarse a esta URL base, seguida de la ruta del endpoint correspondiente (p. ej., https://api.enconvert.com/v1/convert/url-to-pdf).

Características principales#

  • 51 endpoints de conversión que cubren documentos, formatos de datos, imágenes y páginas web
  • Inteligencia web (V2, beta): percibe, descubre, busca, extrae, ingiere y monitorea páginas web mediante seis endpoints /v2, todos ya operativos hoy
  • Dos métodos de autenticación: claves privadas para integración servidor a servidor y claves públicas con JWT para uso del lado del cliente
  • Procesamiento por lotes: convierte varios archivos o URLs en una sola solicitud
  • Modos síncrono y asíncrono: obtén resultados de inmediato o consulta el estado hasta la finalización en trabajos de larga duración
  • Notificaciones de trabajos: recibe callbacks webhook cuando finalizan las conversiones asíncronas
  • Widgets web: integra la funcionalidad de conversión directamente en tu aplicación web
  • No requiere SDK: usa solicitudes HTTP estándar desde cualquier lenguaje o plataforma

Conversiones compatibles#

Páginas web#

Conversión Endpoint
URL a PDF /v1/convert/url-to-pdf
URL a captura de pantalla /v1/convert/url-to-screenshot
URL a Markdown /v1/convert/url-to-markdown
Sitio web a PDF /v1/convert/website-to-pdf
Sitio web a captura de pantalla /v1/convert/website-to-screenshot

Formatos de datos#

Conversión Endpoint
JSON a XML /v1/convert/json-to-xml
XML a JSON /v1/convert/xml-to-json
JSON a YAML /v1/convert/json-to-yaml
YAML a JSON /v1/convert/yaml-to-json
JSON a CSV /v1/convert/json-to-csv
CSV a JSON /v1/convert/csv-to-json
JSON a TOML /v1/convert/json-to-toml
TOML a JSON /v1/convert/toml-to-json
CSV a XML /v1/convert/csv-to-xml
XML a CSV /v1/convert/xml-to-csv
Markdown a HTML /v1/convert/markdown-to-html

Documentos a PDF#

Conversión Endpoint
HTML a PDF /v1/convert/html-to-pdf
Markdown a PDF /v1/convert/markdown-to-pdf
Word a PDF /v1/convert/doc-to-pdf
Excel a PDF /v1/convert/excel-to-pdf
PowerPoint a PDF /v1/convert/ppt-to-pdf
Pages a PDF /v1/convert/pages-to-pdf
Numbers a PDF /v1/convert/numbers-to-pdf
ODT a PDF /v1/convert/odt-to-pdf
ODS a PDF /v1/convert/ods-to-pdf
ODP a PDF /v1/convert/odp-to-pdf
OTS a PDF /v1/convert/ots-to-pdf
Cualquier documento a PDF /v1/convert/anything-to-pdf
Cualquier documento a Markdown /v1/convert/anything-to-markdown

Conversiones de imágenes#

Conversión Endpoint
JPEG a PNG /v1/convert/jpeg-to-png
PNG a JPEG /v1/convert/png-to-jpeg
JPEG a SVG /v1/convert/jpeg-to-svg
SVG a JPEG /v1/convert/svg-to-jpeg
JPEG a HEIC /v1/convert/jpeg-to-heic
HEIC a JPEG /v1/convert/heic-to-jpeg
JPEG a WebP /v1/convert/jpeg-to-webp
WebP a JPEG /v1/convert/webp-to-jpeg
PNG a SVG /v1/convert/png-to-svg
SVG a PNG /v1/convert/svg-to-png
PNG a HEIC /v1/convert/png-to-heic
HEIC a PNG /v1/convert/heic-to-png
PNG a WebP /v1/convert/png-to-webp
WebP a PNG /v1/convert/webp-to-png
SVG a HEIC /v1/convert/svg-to-heic
HEIC a SVG /v1/convert/heic-to-svg
SVG a WebP /v1/convert/svg-to-webp
WebP a SVG /v1/convert/webp-to-svg
HEIC a WebP /v1/convert/heic-to-webp
WebP a HEIC /v1/convert/webp-to-heic
PDF a JPEG /v1/convert/pdf-to-jpeg
Comprimir una imagen /v1/convert/compress-image

Inteligencia web (V2)#

Los endpoints V2 transforman una URL en algo que una aplicación puede utilizar: Markdown limpio, datos estructurados, un conjunto de resultados de búsqueda, fragmentos listos para RAG o una alerta de cambios. Se ejecutan sobre el mismo motor Chrome headless y las mismas claves de API que los endpoints de conversión, consumen la misma cuota mensual unificada de ops y tienen su propio estado beta.

Endpoint Qué hace
/v2/perceive Renderiza una URL una vez y devuelve Markdown, HTML, una captura de pantalla, un PDF, enlaces y datos estructurados de ese único renderizado.
/v2/discover Enumera las URLs de un sitio a partir de su sitemap y un rastreo HTTP, sin renderizar cada página.
/v2/lookup Ejecuta una búsqueda web, de noticias, académica o de mapas, y opcionalmente percibe los resultados principales.
/v2/distill Extrae datos que coincidan con un esquema JSON, con una pasada gratuita mediante CSS y un respaldo asistido por LLM.
/v2/ingest Rastrea un sitio y lo convierte en fragmentos listos para RAG y un archivo JSONL, entregado de forma asíncrona.
/v2/watch Monitorea una URL en busca de cambios y te notifica por webhook o correo electrónico cuando cambia.

Los seis ya se pueden llamar hoy con la misma clave. Perceive e Ingest tienen disponibilidad general; Distill, Lookup, Watch y Discover están en beta privada, así que sus formas de solicitud y respuesta pueden cambiar sin avisar y sus páginas siguen en Próximamente.

Una cuota unificada: Las conversiones V1 y las operaciones V2 consumen una única cuota mensual de ops. Cada unidad de trabajo cuesta una op: una conversión de archivo, una URL percibida o destilada, una página ingerida, una consulta de lookup, una llamada a discover. No hay multiplicadores de créditos ni contadores por endpoint. Asignaciones por nivel: Founding 500, Indie 3.000, Studio 15.000, Production 50.000 ops al mes (Enterprise a medida). Los watchers tienen un tope separado, y la extracción con LLM consume créditos de IA mensuales en lugar de ops. Consulta el resumen de V2 y la página de precios.

Preguntas frecuentes#

¿Qué formatos de archivo puedo convertir con la API de conversión de archivos de EnConvert?#

La API expone 51 endpoints de conversión en cuatro categorías: páginas web (URL a PDF, captura de pantalla o Markdown), formatos de datos (JSON, XML, YAML, CSV, TOML, Markdown, HTML), documentos a PDF (Word, Excel, PowerPoint, Pages, Numbers y formatos OpenDocument) y conversiones de imágenes (JPEG, PNG, SVG, HEIC, WebP).

¿Necesito un SDK para usar la API de conversión de archivos?#

No. EnConvert no requiere ningún SDK: realizas solicitudes HTTP estándar desde cualquier lenguaje o plataforma a la URL base https://api.enconvert.com, seguida de la ruta del endpoint, como /v1/convert/url-to-pdf.

¿La API admite conversión de archivos asíncrona?#

Sí. La API ofrece modos síncrono y asíncrono: obtén resultados de inmediato o consulta el estado hasta la finalización en trabajos de larga duración, y las notificaciones de trabajos entregan callbacks webhook cuando finalizan las conversiones asíncronas.

¿Cómo me autentico con la API de EnConvert?#

Se admiten dos métodos de autenticación: claves privadas para integración servidor a servidor y claves públicas con JWT para uso del lado del cliente.

Adónde ir a continuación#

  • Guía rápida pone en marcha una primera conversión con cURL, Python o Node.js.
  • Conceptos explica las superficies de acceso, los trabajos síncronos y asíncronos, las URLs de salida firmadas y en qué se diferencian V1 y V2.
  • Endpoints es la referencia de Perceive, Ingest y todas las rutas de conversión, además de los parámetros de solicitud que comparten.
  • Guías cubre la ingesta de archivos, los webhooks, el procesamiento por lotes y las integraciones: MCP, n8n, la CLI y los SDKs.