Diese Seite ist auch auf English verfügbar
Offizielle REST-API

Eine HTTP-API. Jede Konvertierung, eine Basis-URL.

Neunundvierzig Konvertierungs-Endpoints für Webseiten, Datenformate, Dokumente und Bilder, plus sechs Web-Intelligence-Endpoints, die Live-Seiten rendern, durchsuchen, extrahieren und überwachen. Alles hängt an api.enconvert.com, und jede Konvertierung antwortet mit einem vorsignierten Download-Link.

curl -X POST https://api.enconvert.com/v1/convert/url-to-pdf -H "X-API-Key: sk_..." -d '{"url":"https://example.com"}'
Authentifizierung

Zwei Key-Typen, nur einen Header entfernt.

Wähle den Key, der zur Herkunft der Anfrage passt. Beide werden im Dashboard erstellt und widerrufen.

Private Keys für deinen Server

Schicke einen Key, der mit sk_ beginnt, im X-API-Key-Header. Voller Zugriff auf jeden Endpoint, einschließlich Sync, Async und Batch. Keys werden als SHA-256-Hashes gespeichert, der Klartext wird also nur einmal bei der Erstellung angezeigt und danach nie wieder.

X-API-Key: sk_...

Public Keys für den Browser

Tausche einen Key, der mit pk_ beginnt, an POST /v1/auth/token gegen ein kurzlebiges JWT, und schicke es dann als Authorization: Bearer. Public Keys funktionieren nur von den Domains, die du auf die Whitelist setzt, und POST /v1/auth/refresh erneuert das Token, bevor es abläuft.

Authorization: Bearer <token>

Ein Private Key, der aus einem Browser verwendet wird, wird rundweg abgelehnt. Die API liest den Origin-Header und verweigert sk_-Keys aus Browser-Umgebungen, sodass ein geleakter Server-Key nicht von einer Seite aus wiederverwendet werden kann.

Authentifizierungs-Guide lesen
Endpoints

Neunundvierzig Konvertierungen. Sechs weitere fürs Web selbst.

Webseiten-Endpoints nehmen einen JSON-Body mit URLs entgegen. Datenformat-, Dokument- und Bild-Endpoints nehmen einen multipart/form-data-Upload entgegen. Die V2-Endpoints nehmen JSON entgegen und teilen sich dieselben Keys und dieselbe Domain-Allowlist, mit eigenen Kontingent-Zählern.

  1. Webseiten

    5 Endpoints

    Rendere jede URL als PDF, Screenshot oder sauberes Markdown, und fasse eine ganze Website zu einem Dokument zusammen. Batch und Async werden beide unterstützt.

    POST /v1/convert/url-to-pdf

  2. Datenformate

    11 Endpoints

    JSON zu und von XML, YAML, CSV und TOML, CSV zu und von XML, und Markdown zu HTML. Strukturierte Daten rein, strukturierte Daten raus.

    POST /v1/convert/json-to-xml

  3. Dokumente zu PDF

    11 Endpoints

    HTML, Markdown, Word, Excel, PowerPoint, die OpenDocument-Familie, Pages und Numbers, alle gerendert zu PDF mit derselben Request-Form.

    POST /v1/convert/doc-to-pdf

  4. Bildkonvertierungen

    22 Endpoints

    JPEG, PNG, WebP, HEIC und SVG in jeder Kombination, plus PDF zu JPEG und ein qualitätsbewusster Kompressor.

    POST /v1/convert/heic-to-webp

  5. Web Intelligence

    6 Endpoints

    perceive, discover, lookup, distill, ingest und watch. Rendere eine Seite, kartiere eine Website, löse eine Entität auf, ziehe strukturierte Felder, baue einbettbare Passagen, und erfahre, wenn sich eine Seite ändert.

    POST /v2/perceive

Fehler kommen als JSON mit einem detail-Feld zurück: 401 für einen fehlenden oder ungültigen Key, 402 wenn das monatliche Limit erreicht ist, 403 für eine Domain oder einen Endpoint, den dein Key nicht nutzen darf, und 413 für eine Datei über dem Größenlimit deines Plans.

Alle Endpoints durchsuchen
In der Praxis

Eine Anfrage und eine Antwort.

Jeder Endpoint folgt derselben Form. Schicke einen Key, bekomm einen vorsignierten Download-Link und die passenden Metadaten zurück.

curl -X POST https://api.enconvert.com/v1/convert/url-to-pdf \  -H "X-API-Key: sk_your_private_key" \  -H "Content-Type: application/json" \  -d '{"url": "https://example.com"}'{  "presigned_url": "https://econverter.nyc3.cdn.digitaloceanspaces.com/...",  "object_key": "live/files/12345/url-to-pdf/example_20250202_120530123.pdf",  "filename": "example_20250202_120530123.pdf",  "file_size": 45678,  "conversion_time_seconds": 3.21}
Darauf aufgebaut

Eine API, vier Wege hinein.

REST ist das Fundament. Jede andere Oberfläche ist ein schlankerer Weg, dieselben Endpoints mit demselben Key zu erreichen.

Node.js-SDK

Typisierte Methoden, Streaming-Downloads, automatische Wiederherstellung nach einem Job-Timeout und eine echte Fehlerhierarchie statt Status-Code-Verzweigungen. Null Laufzeit-Abhängigkeiten, ESM und CJS.

Auf npm ansehen

Kommandozeilen-Tool

Die ganze API als ein Terminal-Befehl, für Shells, Skripte und CI-Jobs, bei denen ein HTTP-Client mehr Aufwand ist, als die Aufgabe verdient.

CLI ansehen

n8n-Node

Konvertiere, scrape und crawle innerhalb eines Workflows, ohne selbst eine Anfrage zu schreiben oder ein Job-Polling zu handhaben.

n8n-Node ansehen

MCP-Server

Dieselben Endpoints als Tools bereitgestellt, die dein Agent direkt aufrufen kann, für Claude, Cursor und Windsurf.

MCP-Server ansehen

Fragen zur API

https://api.enconvert.com. Jeder v1- und v2-Endpoint hängt an dieser einen Basis-URL, es gibt also nichts Regionales oder Mandantenspezifisches zu konfigurieren.
Für Server-zu-Server-Aufrufe schickst du einen Private Key, der mit sk_ beginnt, im X-API-Key-Header. Für Browser-Aufrufe tauschst du einen Public Key, der mit pk_ beginnt, an POST /v1/auth/token gegen ein kurzlebiges JWT und schickst es als Authorization: Bearer. Public Keys funktionieren nur von den Domains, die du im Dashboard auf die Whitelist setzt.
V1 sind die 49 Konvertierungs-Endpoints: Dateien und Webseiten rein, konvertierte Dateien raus. V2 sind sechs Web-Intelligence-Endpoints (perceive, discover, lookup, distill, ingest und watch), die Live-Seiten rendern, durchsuchen, extrahieren und überwachen. Sie nutzen dieselben Keys und dieselbe Domain-Allowlist und werden über getrennte Zähler abgerechnet.
Beides, je nach Endpoint. Die fünf Webseiten-Endpoints nehmen einen JSON-Body mit der URL entgegen. Die Datenformat-, Dokument- und Bild-Endpoints nehmen einen multipart/form-data-Datei-Upload entgegen.
Die API antwortet mit 402 und einem detail-Feld, das die genutzten und erlaubten Zahlen nennt. Ein Batch, der dich über dein verbleibendes Kontingent bringen würde, wird von vornherein abgelehnt statt teilweise verarbeitet, sodass du nie für einen halb fertigen Lauf bezahlst.
Ja, @enconvert/node-sdk für Node.js und TypeScript. Es ruft dieselben öffentlichen Endpoints auf, hat null Laufzeit-Abhängigkeiten und liefert sowohl ESM- als auch CJS-Builds, sodass sich SDK-Aufrufe und rohe HTTP-Aufrufe in einer Codebasis frei mischen lassen.

Starte mit einer Anfrage.

Der Quickstart führt dich in drei Schritten durch deine erste Konvertierung, mit Beispielen für cURL, Python und JavaScript.

Quickstart lesenAPI-Key holen