EnConvert Datei-Konvertierungs-API#
EnConvert ist eine RESTful-API zur Konvertierung von Dokumenten, Bildern, Datenformaten und Webseiten zwischen verschiedenen Formaten. Sie wandelt zum Beispiel eine URL über /v1/convert/url-to-pdf in ein PDF um. Sie gibt Entwicklern programmatischen Zugriff auf 51 Konvertierungs-Endpunkte plus sechs V2-Web-Intelligence-Endpunkte, ohne dass eine eigene Konvertierungs-Infrastruktur verwaltet werden muss. Anfragen laufen synchron oder asynchron, und die Stapelverarbeitung konvertiert mehrere Dateien oder URLs in einer einzigen Anfrage.
Basis-URL:
https://api.enconvert.com
Alle API-Anfragen erfolgen an diese Basis-URL, gefolgt vom jeweiligen Endpunkt-Pfad (z. B. https://api.enconvert.com/v1/convert/url-to-pdf).
Wichtigste Funktionen#
- 51 Konvertierungs-Endpunkte für Dokumente, Datenformate, Bilder und Webseiten
- Web Intelligence (V2, Beta) -- Webseiten wahrnehmen, entdecken, durchsuchen, extrahieren, einlesen und überwachen über sechs
/v2-Endpunkte, die alle bereits heute aufrufbar sind - Zwei Authentifizierungsmethoden -- private Keys für Server-zu-Server-Integrationen und öffentliche Keys mit JWT für die clientseitige Nutzung
- Stapelverarbeitung -- mehrere Dateien oder URLs in einer einzigen Anfrage konvertieren
- Synchroner und asynchroner Modus -- Ergebnisse sofort erhalten oder den Abschluss lang laufender Jobs abfragen
- Job-Benachrichtigungen -- Webhook-Callbacks erhalten, sobald asynchrone Konvertierungen abgeschlossen sind
- Web-Widgets -- Konvertierungsfunktionen direkt in deine Webanwendung einbetten
- Kein SDK erforderlich -- Standard-HTTP-Anfragen aus jeder Sprache oder Plattform verwenden
Unterstützte Konvertierungen#
Webseiten#
| Konvertierung | Endpunkt |
|---|---|
| URL zu PDF | /v1/convert/url-to-pdf |
| URL zu Screenshot | /v1/convert/url-to-screenshot |
| URL zu Markdown | /v1/convert/url-to-markdown |
| Website zu PDF | /v1/convert/website-to-pdf |
| Website zu Screenshot | /v1/convert/website-to-screenshot |
Datenformate#
| Konvertierung | Endpunkt |
|---|---|
| JSON zu XML | /v1/convert/json-to-xml |
| XML zu JSON | /v1/convert/xml-to-json |
| JSON zu YAML | /v1/convert/json-to-yaml |
| YAML zu JSON | /v1/convert/yaml-to-json |
| JSON zu CSV | /v1/convert/json-to-csv |
| CSV zu JSON | /v1/convert/csv-to-json |
| JSON zu TOML | /v1/convert/json-to-toml |
| TOML zu JSON | /v1/convert/toml-to-json |
| CSV zu XML | /v1/convert/csv-to-xml |
| XML zu CSV | /v1/convert/xml-to-csv |
| Markdown zu HTML | /v1/convert/markdown-to-html |
Dokumente zu PDF#
| Konvertierung | Endpunkt |
|---|---|
| HTML zu PDF | /v1/convert/html-to-pdf |
| Markdown zu PDF | /v1/convert/markdown-to-pdf |
| Word zu PDF | /v1/convert/doc-to-pdf |
| Excel zu PDF | /v1/convert/excel-to-pdf |
| PowerPoint zu PDF | /v1/convert/ppt-to-pdf |
| Pages zu PDF | /v1/convert/pages-to-pdf |
| Numbers zu PDF | /v1/convert/numbers-to-pdf |
| ODT zu PDF | /v1/convert/odt-to-pdf |
| ODS zu PDF | /v1/convert/ods-to-pdf |
| ODP zu PDF | /v1/convert/odp-to-pdf |
| OTS zu PDF | /v1/convert/ots-to-pdf |
| Beliebiges Dokument zu PDF | /v1/convert/anything-to-pdf |
| Beliebiges Dokument zu Markdown | /v1/convert/anything-to-markdown |
Bildkonvertierungen#
| Konvertierung | Endpunkt |
|---|---|
| JPEG zu PNG | /v1/convert/jpeg-to-png |
| PNG zu JPEG | /v1/convert/png-to-jpeg |
| JPEG zu SVG | /v1/convert/jpeg-to-svg |
| SVG zu JPEG | /v1/convert/svg-to-jpeg |
| JPEG zu HEIC | /v1/convert/jpeg-to-heic |
| HEIC zu JPEG | /v1/convert/heic-to-jpeg |
| JPEG zu WebP | /v1/convert/jpeg-to-webp |
| WebP zu JPEG | /v1/convert/webp-to-jpeg |
| PNG zu SVG | /v1/convert/png-to-svg |
| SVG zu PNG | /v1/convert/svg-to-png |
| PNG zu HEIC | /v1/convert/png-to-heic |
| HEIC zu PNG | /v1/convert/heic-to-png |
| PNG zu WebP | /v1/convert/png-to-webp |
| WebP zu PNG | /v1/convert/webp-to-png |
| SVG zu HEIC | /v1/convert/svg-to-heic |
| HEIC zu SVG | /v1/convert/heic-to-svg |
| SVG zu WebP | /v1/convert/svg-to-webp |
| WebP zu SVG | /v1/convert/webp-to-svg |
| HEIC zu WebP | /v1/convert/heic-to-webp |
| WebP zu HEIC | /v1/convert/webp-to-heic |
| PDF zu JPEG | /v1/convert/pdf-to-jpeg |
| Bild komprimieren | /v1/convert/compress-image |
Web Intelligence (V2)#
Die V2-Endpunkte verwandeln eine URL in etwas, das eine Anwendung direkt nutzen kann: sauberes Markdown, strukturierte Daten, eine Suchergebnismenge, RAG-taugliche Chunks oder eine Änderungsbenachrichtigung. Sie laufen auf derselben Headless-Chrome-Engine und mit denselben API-Keys wie die Konvertierungs-Endpunkte, schöpfen aus demselben einheitlichen monatlichen Ops-Kontingent und haben ihren eigenen Beta-Status.
| Endpunkt | Was er tut |
|---|---|
/v2/perceive |
Rendert eine URL einmal und liefert aus diesem einen Rendering Markdown, HTML, einen Screenshot, ein PDF, Links und strukturierte Daten. |
/v2/discover |
Listet die URLs einer Website anhand ihrer Sitemap und eines HTTP-Crawls auf, ohne jede Seite zu rendern. |
/v2/lookup |
Führt eine Web-, News-, Scholar- oder Maps-Suche aus und nimmt optional die Top-Ergebnisse wahr. |
/v2/distill |
Extrahiert Daten passend zu einem JSON-Schema, mit einem kostenlosen CSS-Durchlauf und einem LLM-gestützten Fallback. |
/v2/ingest |
Crawlt eine Website zu RAG-tauglichen Chunks und einer einzigen JSONL-Datei, asynchron zugestellt. |
/v2/watch |
Überwacht eine URL auf Änderungen und benachrichtigt dich per Webhook oder E-Mail, sobald sie sich ändert. |
Alle sechs sind heute mit demselben Schlüssel aufrufbar. Perceive und Ingest sind allgemein verfügbar; Distill, Lookup, Watch und Discover stehen in privater Beta, ihre Request- und Response-Formen können sich also ohne Vorankündigung ändern, und ihre Seiten bleiben unter Demnächst.
Häufig gestellte Fragen#
Welche Dateiformate kann ich mit der EnConvert Datei-Konvertierungs-API konvertieren?#
Die API stellt 51 Konvertierungs-Endpunkte in vier Kategorien bereit: Webseiten (URL zu PDF, Screenshot oder Markdown), Datenformate (JSON, XML, YAML, CSV, TOML, Markdown, HTML), Dokumente zu PDF (Word, Excel, PowerPoint, Pages, Numbers und OpenDocument-Formate) sowie Bildkonvertierungen (JPEG, PNG, SVG, HEIC, WebP).
Brauche ich ein SDK, um die Datei-Konvertierungs-API zu nutzen?#
Nein. EnConvert benötigt kein SDK: Du stellst Standard-HTTP-Anfragen aus jeder Sprache oder Plattform an die Basis-URL https://api.enconvert.com, gefolgt vom Endpunkt-Pfad wie /v1/convert/url-to-pdf.
Unterstützt die API asynchrone Dateikonvertierung?#
Ja. Die API bietet einen synchronen und einen asynchronen Modus: Ergebnisse lassen sich sofort abrufen oder der Abschluss lang laufender Jobs abfragen. Zusätzlich liefern Job-Benachrichtigungen Webhook-Callbacks, sobald asynchrone Konvertierungen abgeschlossen sind.
Wie authentifiziere ich mich bei der EnConvert-API?#
Es werden zwei Authentifizierungsmethoden unterstützt: private Keys für Server-zu-Server-Integrationen und öffentliche Keys mit JWT für die clientseitige Nutzung.
Wohin als Nächstes#
- Schnellstart bringt eine erste Konvertierung mit cURL, Python oder Node.js zum Laufen.
- Konzepte erklärt die Zugangswege, synchrone und asynchrone Jobs, signierte Ausgabe-URLs und wie sich V1 und V2 unterscheiden.
- Endpunkte ist die Referenz für Perceive, Ingest und jede Konvertierungsroute samt der gemeinsam genutzten Anfrageparameter.
- Leitfäden behandelt Datei-Ingestion, Webhooks, Stapelverarbeitung und die Integrationen: MCP, n8n, das CLI und die SDKs.