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.

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

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