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.

Beta: Die EnConvert-API befindet sich derzeit in der Beta-Phase. Endpunkte, Parameter und Antwortformate können sich ändern, während wir die Plattform anhand von Entwickler-Feedback weiterentwickeln. Wir empfehlen, dich auf dokumentiertes Verhalten zu verlassen statt auf undokumentierte Felder.

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.

Ein einheitliches Kontingent: V1-Konvertierungen und V2-Operationen schöpfen aus einem einzigen monatlichen Ops-Kontingent. Jede Arbeitseinheit kostet eine Op: eine Dateikonvertierung, eine per perceive oder distill verarbeitete URL, eine ingestierte Seite, eine Lookup-Query, ein Discover-Aufruf. Es gibt keine Credit-Multiplikatoren und keine Zähler pro Endpunkt. Kontingente je Tarif: Founding 500, Indie 3.000, Studio 15.000, Production 50.000 Ops pro Monat (Enterprise individuell). Watcher haben ein separates Limit, und LLM-Extraktion verbraucht monatliche AI-Credits statt Ops. Siehe den V2-Überblick und die Preisseite.

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.