EnConvert: die Web-Reading-API, die jede zurückgegebene Seite bewertet#
EnConvert liest jede URL und jede Datei für KI-Agenten. /v2/perceive rendert eine Live-Seite und liefert sauberes Markdown, JSON oder einen Screenshot, und jeder Web-Read trägt einen render_quality-Score von 0 bis 1 samt den benannten deductions, die ihn gesenkt haben, etwa anti_bot_challenge, login_wall, soft_404 und unhydrated_shell. Challenge-Seiten, Login-Walls und leere App-Hüllen kommen markiert zurück statt als 200, der dein Agent glaubt. Für Dateien wandelt /v1/convert/anything-to-markdown PDF-, Word-, PowerPoint-, Excel- und weitere Dokumente in Markdown mit sauberer Überschriftenstruktur um.
Den Überblick zum Lesen einer URL als Markdown gibt die Seite URL to Markdown API.
Die Dateikonvertierung ist die zweite Fähigkeit, mit demselben API-Key und derselben Basis-URL: 51 Konvertierungs-Endpunkte wandeln Dokumente, Bilder, Datenformate und Webseiten in andere Formate um, zum Beispiel eine URL über /v1/convert/url-to-pdf in ein PDF. 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, Ingest, Distill, Lookup und Discover sind allgemein verfügbar; Distill braucht einen kostenpflichtigen Tarif. Watch steht in privater Beta, seine Request- und Response-Formen können sich also ohne Vorankündigung ändern, und seine Seite bleibt unter Demnächst.
Häufig gestellte Fragen#
Welche Dateiformate kann ich mit EnConvert 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 EnConvert-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.