EnConvert: la API de lectura web que puntúa cada página que devuelve#
EnConvert lee cualquier URL o archivo para agentes de IA. /v2/perceive renderiza una página en vivo y devuelve Markdown limpio, JSON o una captura de pantalla, y cada lectura web incluye una puntuación render_quality de 0 a 1 junto con las deductions con nombre que la redujeron, como anti_bot_challenge, login_wall, soft_404 y unhydrated_shell. Las páginas de desafío, los muros de inicio de sesión y los shells de aplicación vacíos vuelven marcados en lugar de llegar como un 200 que tu agente se cree. Para archivos, /v1/convert/anything-to-markdown convierte PDF, Word, PowerPoint, Excel y otros documentos en Markdown con encabezados bien estructurados.
Para una visión general de cómo leer una URL en Markdown, consulta la página URL to Markdown API.
La conversión de archivos es la segunda capacidad, con la misma clave de API y la misma URL base: 51 endpoints de conversión transforman documentos, imágenes, formatos de datos y páginas web a otros formatos; por ejemplo, convierten una URL en un PDF mediante /v1/convert/url-to-pdf. 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, Ingest, Distill, Lookup y Discover tienen disponibilidad general; Distill necesita un plan de pago. Watch está en beta privada, así que sus formas de solicitud y respuesta pueden cambiar sin avisar y su página sigue en Próximamente.
Preguntas frecuentes#
¿Qué formatos de archivo puedo convertir con 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 EnConvert?#
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.