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.
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.
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.