PDF-API
Zum Zusammenführen, Komprimieren, Teilen, Drehen, Konvertieren oder Anwenden von OCR auf ein PDF sind weder API-Schlüssel noch Konto noch Registrierung nötig. PDFs zusammenführen, komprimieren, teilen, drehen, konvertieren und OCR über einfaches HTTP. Datei senden, ID erhalten, Ergebnis herunterladen.
Zuletzt aktualisiert: 1. September 2026
Dies ist dieselbe Engine, die ScanReviver Website Es funktioniert online. Anrufe sind innerhalb der unten genannten Grenzen kostenlos, und eine Registrierung ist nicht erforderlich.
So funktioniert ein Aufruf
Jeder Job besteht aus zwei Schritten. Sie POST Ihre Datei und erhalten Sie ein kleines JSON-Objekt mit einem idSie dann GET das Ergebnis mit dieser ID. Der Grund für die Aufteilung ist, dass ein Job mehr als eine Ausgabe erzeugen kann: eine zusammengeführte PDF, eine einzelne Seite oder ein ZIP von Bildern.
# step 1: send two PDFs to be merged
$ curl -s -F "files=@a.pdf" -F "files=@b.pdf" \
https://scanreviver.com/api/pdf-merge
{"id":"5ea56646f09146979eabc2faecd0f889","bytes":72597,"files":2}
# step 2: download the merged file
$ curl -s -o merged.pdf \
https://scanreviver.com/api/pdf-file/5ea56646f09146979eabc2faecd0f889Endpunkte
Alle diese nehmen multipart/form-data und geben JSON mit einem id.
| Endpunkt | Senden | Dann abrufen von |
|---|---|---|
POST /api/pdf-merge | files, ein Feld pro PDF wiederholt | /api/pdf-file/{id} |
POST /api/pdf-compress | file, plus level (good standardmäßig) | /api/pdf-file/{id} |
POST /api/pdf-split | file | /api/pdf-split-file/{id} |
POST /api/pdf-to-images | file | /api/pdf-zip/{id}, oder Seite für Seite aus /api/pdf-page/{id}/{n} |
POST /api/pdf-to-word | file | /api/pdf-word/{id} |
POST /api/pdf-to-excel | file | /api/pdf-excel/{id} |
POST /api/pdf-to-ppt | file | /api/pdf-ppt/{id} |
POST /api/ocr-text | file | Nichts, der Text wird in derselben Antwort zurückgegeben. |
Die Website hat mehr Endpunkte als diese, darunter Drehen, Zuschneiden, Seitenzahlen, Wasserzeichen, Formulare und Signieren. Sie folgen dem gleichen zweistufigen Ablauf. Wenn Sie einen benötigen, der hier nicht aufgeführt ist, fragen Sie im Kontaktseite Und wir werden es richtig dokumentieren, anstatt Sie raten zu lassen.
Die Texterkennung gibt den Text direkt zurück.
/api/ocr-text ist derjenige, der keinen zweiten Aufruf benötigt, da das Ergebnis Text und keine Datei ist:
$ curl -s -F "file=@invoice.pdf" https://scanreviver.com/api/ocr-text
{"text":"Invoice 2026 total 42 euro","pages":1,"total_pages":1,"chars":26}Einschränkungen
| Maximal pro Datei | 250 MB (PDF zu PowerPoint: 25 MB) |
|---|---|
| Maximal pro Aufgabe | 1000 MB |
| Seiten pro PDF | 25 (OCR liest die ersten 15) |
| Gleichzeitige Aufträge | Bitte nur 1 gleichzeitig (nicht erzwungen) |
| Aufgaben pro Tag | Keine Begrenzung |
| Das Ergebnis bleibt verfügbar. | 45 Minuten |
Die 45 Minuten sind wichtig: Laden Sie das Ergebnis im selben Durchlauf Ihres Skripts herunter. Eine ID, die Sie gestern gespeichert haben, funktioniert nicht, und das ist Absicht, nichts von Ihren Daten verbleibt länger als nötig auf unserer Festplatte.
Fehler
Fehler werden als JSON und nicht als Datei zurückgegeben. Überprüfen Sie daher den Statuscode, bevor Sie den Inhalt irgendwo speichern.
| Status | Bedeutung |
|---|---|
400 | Die Datei kann für diese Operation nicht verwendet werden, oder die Aufgaben-ID ist unbekannt oder älter als 45 Minuten. Die Meldung gibt an, was zutrifft. |
413 | Zu groß oder zu viele Seiten. |
422 | Ein erforderliches Formularfeld fehlt. |
429 | Sie haben bereits einen Job, der von dieser Adresse aus ausgeführt wird. |
Eine nützliche zu erwarten: Senden eines gescannten PDF an den Word-Konverter ergibt ein 400 teilt Ihnen mit, dass Sie zuerst eine Texterkennung durchführen sollten, da die Datei keinen echten Text enthält, der konvertiert werden kann.
Python, von Anfang bis Ende
import requests
BASE = "https://scanreviver.com"
r = requests.post(f"{BASE}/api/pdf-merge",
files=[("files", open("a.pdf", "rb")),
("files", open("b.pdf", "rb"))],
timeout=180)
r.raise_for_status()
job = r.json()["id"]
out = requests.get(f"{BASE}/api/pdf-file/{job}", timeout=180)
out.raise_for_status()
open("merged.pdf", "wb").write(out.content)Verwendung in Ihrem eigenen Projekt
Bauen Sie darauf auf, auch in etwas, wofür Sie Geld verlangen. Zwei Dinge, um die wir bitten, beide nicht erzwungen: Starten Sie jeweils nur einen Auftrag, damit jeder an die Reihe kommt, und wenn Ihr Projekt auflistet, was es verwendet, verlinken Sie zurück auf scanreviver.com. Dadurch bleibt das hier kostenlos.
Planst du größere Mengen? Sag Hallo auf der Kontaktseite zuerst. Wir würden lieber von Ihnen hören, als Sie zu drosseln.
Fragen
Benötige ich einen API-Schlüssel?
Nein. Es gibt keinen Schlüssel, kein Konto und keine Registrierung: Sie laden Ihre Datei einfach an den benötigten Endpunkt hoch und erhalten eine Job-ID zurück.
Was ist eine PDF-API?
Eine API, mit der Sie eine PDF-Datei über HTTP senden und ein Ergebnis zurückerhalten können, z. B. eine komprimierte Datei, extrahierten Text oder ein konvertiertes Dokument. Es ist kein Browser erforderlich; sie funktioniert mit jedem Skript oder jeder Anwendung.
Kann ich PDFs programmatisch verarbeiten?
Ja. Sie können eine Datei an den Endpunkt senden, erhalten eine Job-ID und rufen das Ergebnis mit einer zweiten Anfrage ab. Dies funktioniert mit curl, Python, Node.js oder jeder anderen Sprache, die HTTP-Anfragen senden kann.
Gibt es eine kostenlose PDF-API?
Ja. Für diese API ist kein Schlüssel, kein Konto und keine tägliche Nutzungsgrenze erforderlich. Die Dateigröße kann bis zu 250 MB betragen, wobei pro PDF maximal 25 Seiten erlaubt sind. Es gibt zwei Ausnahmen: Bei der Konvertierung von PDF zu PowerPoint können Dateien bis zu 25 MB groß sein, und der OCR-Endpunkt kann bis zu 15 Seiten verarbeiten.
Wie konvertiere ich ein PDF über die API?
Laden Sie die Datei an den entsprechenden Endpunkt hoch, z. B. /api/pdf-to-word, und rufen Sie das Ergebnis vom entsprechenden Download-Pfad ab. Die Tabelle der Endpunkte auf dieser Seite listet alle verfügbaren Konvertierungen auf.
Warum wird eine ID und nicht die Datei zurückgegeben?
Die PDF-Verarbeitung kann aus einem Job mehrere Ausgaben erzeugen, z. B. einen Seitenbereich oder eine vollständige ZIP-Datei. Die POST-Anfrage gibt eine Job-ID zurück, und eine zweite GET-Anfrage ruft das gewünschte Ergebnis ab. Das Zusammenführen und Komprimieren gibt die PDF-Datei von /api/pdf-file/{id} zurück.
Wie lange ist das Ergebnis verfügbar?
45 Minuten. Danach funktioniert die Job-ID nicht mehr und die Datei ist gelöscht. Laden Sie sie daher im selben Skript herunter, anstatt die ID für später zu speichern.
Gibt es eine tägliche Begrenzung?
Nein. Es gibt keine tägliche Begrenzung und kein Limit pro Schlüssel. Der Server bearbeitet jeweils nur eine bestimmte Anzahl von Aufträgen, sodass bei hoher Auslastung ein Auftrag etwas länger dauern kann; bitte reichen Sie jeweils nur einen Auftrag ein.
Ändert der kostenpflichtige Pass die API-Limits?
Die Pass erhöht die Dateigröße und Seitenzahl auf der Website. Behandeln Sie die Zahlen auf dieser Seite als das, was Sie ohne eine erhalten.
Kann es ein gescanntes PDF lesen?
Ja, über den OCR-Endpunkt, der den erkannten Text als JSON zurückgibt. Die Word- und Excel-Konverter benötigen ein PDF, das bereits echten Text enthält, und teilen Ihnen dies mit, falls dies nicht der Fall ist.