Person und Kontaktdaten
Berufsbezeichnung, Vor- und Nachname, Adresse, Ort, Land, Telefon und vorhandene E-Mail-Adressen.
CV-Parsing-REST-API · ATS- und HR-Integration
Integrieren Sie CV-Parsing über eine REST-API in Ihr ATS
Senden Sie einen Lebenslauf an die CVReaderPro-REST-API, erhalten Sie eine strukturierte Antwort und nutzen Sie die Daten in Ihrem ATS, Ihrer HR-Software oder Geschäftsanwendung.
14 Tage Testphase · 200 Credits · keine Kreditkarte
Vom Dokument zu Daten
CV senden → strukturierte Daten → Nutzung in Ihrer Software
CVReaderPro extrahiert Daten aus dem Dokument. Ihr Backend erhält die Antwort und entscheidet, wie sie Ihrem Kandidatenmodell zugeordnet, gespeichert und angezeigt wird.
- 01
1. CV senden
Ihr Backend übermittelt die Datei an einen Parsing-Endpunkt.
- 02
2. Parser wählen
Wählen Sie den Modus passend zu Dokument und Detailbedarf.
- 03
3. Daten erhalten
Die API gibt strukturierte Eigenschaften als JSON- oder XML-Antwort zurück.
- 04
4. Ergebnis nutzen
Ihre Anwendung ordnet die Felder Ihrem ATS, CRM oder Ihrer Kandidatendatenbank zu.
Welche Daten lassen sich aus einem CV abrufen?
Die zurückgegebenen Eigenschaften hängen vom gewählten Parser und den Angaben im Dokument ab.
Berufserfahrung
Positionen, Arbeitgeber, Zeiträume, Orte, Beschreibungen und Kennzeichnung einer aktuellen Stelle.
Ausbildung
Abschlüsse, Bildungseinrichtungen, Daten und verfügbare Beschreibungen.
Kompetenzen und Sprachen
Strukturierte Kompetenzen, erkannte Sprachen und identifizierbare Niveaus.
Profil und Erfahrungsniveau
Profiltext, Berufserfahrungsniveau und Bildungsniveau, soweit vom Parser zurückgegeben.
Weitere Eigenschaften
Soft Skills, Referenzen, Social Links, Hobbys und extrahierter Text, sofern im Schema vorgesehen.
56 oder 96 Felder bezeichnen verfügbare Eigenschaften, nicht garantiert ausgefüllte Werte. Fehlende oder nicht nutzbare Angaben können leer bleiben.
Vollständige Schemas in der Dokumentation ansehenAntwortbeispiel
Vom CV zu strukturiertem JSON
Links steht ein synthetischer CV als PDF, rechts die zugehörige AI-56-JSON-Antwort aus den öffentlichen Beispielen. Das Beispiel zeigt Daten, die ein ATS in sein eigenes Kandidatenmodell übernehmen kann.
Synthetischer Quell-CV
Alex Sample — Senior Java Engineer — Paris. Fiktives Profil zur Veranschaulichung des Ablaufs.
Quell-CV herunterladen (PDF)Die Werte sind fiktiv. Ausgefüllte Felder und Inhalte hängen vom CV und vom gewählten Parser ab.
Vollständige JSON-Datei herunterladen{
"documentType": "CV",
"documentLanguage": "en",
"candidate": {
"jobTitle": "Senior Java Engineer",
"title": "Mr",
"firstName": "Alex",
"lastName": "Sample",
"dayOfBirth": "",
"monthOfBirth": "",
"yearOfBirth": "",
"address": "Paris, France",
"postalCode": "",
"city": "Paris",
"country": "FR",
"department": "",
"region": "",
"phone": "",
"mobilePhone": "",
"driverLicense": "",
"personalEmail": "alex.sample@example.invalid",
"professionalEmail": "",
"nationality": "",
"children": ""
},
"profile": "Synthetic senior Java engineer with 8 years of experience developing Java, Spring Boot and PostgreSQL services. Builds REST APIs and leads engineering teams.",
"experienceLevel": "96",
"experiences": [
{
"startMonth": "01",
"endMonth": "10",
"startYear": "2020",
"endYear": "2026",
"mission": "Senior Java Engineer",
"company": "Example Systems (synthetic)",
"location": null,
"description": "Built Spring Boot REST APIs and PostgreSQL services. Led a team of four engineers. Introduced CI pipelines and automated integration checks.",
"currentPosition": true
},
{
"startMonth": "09",
"endMonth": "12",
"startYear": "2018",
"endYear": "2019",
"mission": "Java Engineer",
"company": "Example Labs (synthetic)",
"location": null,
"description": "Developed Java backend services, SQL reports and REST integrations.",
"currentPosition": false
}
],
"educationLevel": "DESS, DEA, Grande Ecoles, Bac +5",
"educations": [
{
"dateReceived": "2018",
"title": "Master of Computer Science",
"school": "Example University (synthetic)",
"description": ""
}
],
"languages": [
{
"name": "English",
"level": "Fluent"
},
{
"name": "French",
"level": "Bilingual"
}
],
"skills": [
{
"name": "Spring Boot",
"level": "Confirmed"
},
{
"name": "Java",
"level": "Confirmed"
},
{
"name": "PostgreSQL",
"level": "Experienced"
}
],
"softSkills": [
"Leadership",
"problem solving",
"communication"
],
"references": [],
"socialLinks": null,
"hobbies": "",
"resumeId": "00000000-0000-0000-0000-000000000001"
}Technischer Schnellstart
Den ersten API-Aufruf ausführen
Authentifizieren Sie die Anfrage serverseitig, senden Sie den CV als multipart/form-data und verarbeiten Sie die strukturierte Antwort.
1. API-Schlüssel erstellen
Erstellen Sie einen Schlüssel in Ihrem Konto und bewahren Sie ihn auf dem Server auf.
2. Dokument senden
Rufen Sie den Standardendpunkt mit der CV-Datei im Feld file auf.
3. Modus wählen
Der Parameter parserType ist beim Standardendpunkt optional.
4. Antwort verarbeiten
Fordern Sie application/json an und ordnen Sie die Eigenschaften Ihrer Software zu.
cURL-Beispiel
curl --fail-with-body -X POST "https://cvreaderpro.com/api/v2/resumes/parser" \
-H "Authorization: ApiKey YOUR_API_KEY" \
-H "Accept: application/json" \
-F "file=@resume.pdf" \
-F "parserType=ADVANCED"Parser-Optionen und erweiterter Endpunkt
Bei POST /api/v2/resumes/parser wählt BASIC das regelbasierte Parsing (56 Felder) und ADVANCED AI 56 (56 Felder). Für AI 96 verwenden Sie POST /api/v2/resumes/extended-parser. Das ist ein separater Endpunkt, kein parserType-Wert des Standardendpunkts.
POST /api/v2/resumes/extended-parserDer erweiterte Parser akzeptiert entweder eine Datei oder ein Textfeld in einer multipart-Anfrage. Senden Sie genau eine Eingabe; prüfen Sie die Zugriffsrechte in der Dokumentation.
API-DokumentationLegen Sie private API-Schlüssel nicht in browserseitigem JavaScript offen. Parameter, Fehler und Limits der Endpunkte stehen in der Dokumentation.
Passende Parsing-Tiefe für Ihre Integration wählen
Wählen Sie den Parser nach Kontextbedarf und Verarbeitungskosten pro CV.
| Modus | Credits / CV | Verfügbare Felder | Typische Verwendung |
|---|---|---|---|
| Regelbasiertes Parsing | 1 | 56 | Standardisierte Extraktion für große CV-Mengen. |
| KI-Parsing 56 | 3 | 56 | KI-Interpretation, wenn das Dokument mehr Kontext erfordert. |
| KI-Parsing 96 | 5 | 96 | Erweiterter Parser für eine detailliertere Darstellung. |
KI 96 verwendet einen eigenen Endpunkt: POST /api/v2/resumes/extended-parser. Er akzeptiert pro Anfrage entweder eine Datei oder einen Texteingang. Der Zugriff kann von einer aktiven Testphase oder dem Tarif des API-Schlüssels abhängen.
Die Zahl verfügbarer Felder garantiert nicht, dass alle Werte aus einem CV extrahiert werden.
Regelbasiertes CV-Parsing ansehenFür technische Teams
Parsing in Ihr ATS oder Ihre HR-Software integrieren
CVReaderPro stellt Parsing und strukturierte Ergebnisse bereit. Ihre Anwendung behält die Kontrolle über Workflow und Datenmodell.
ATS-Anbieter
CV-Extraktion in den Bewerbungseingang integrieren und die Antwort Ihrem Kandidatenmodell zuordnen.
HR-Software
Relevante Daten an Kandidatenprofile und bestehende HR-Abläufe übergeben.
IT-Dienstleister und interne Integrationen
Parsing mit Geschäftsanwendungen, Kandidatenportalen oder Verarbeitungspipelines verbinden.
Technische Teams
Antworten im Backend verarbeiten, Fehler verwalten und Anzeige sowie Speicherung der Daten festlegen.
Die API liefert strukturierte Daten, aber keinen nativen Konnektor für jedes ATS. Mapping, Oberfläche und Geschäftsregeln werden in Ihrer Software implementiert oder konfiguriert.
Antworten, Fehler und Webhooks
Berücksichtigen Sie erfolgreiche Antworten, Fehler und asynchrone Ereignisse in Ihrer Integration.
Standard-Parsing
POST /api/v2/resumes/parserPOST /api/v2/resumes/parser liefert je nach Accept-Header HTTP 200 als JSON oder XML.
400Ungültige CV-Datei.401API-Schlüssel fehlt oder ist ungültig.402Nicht genügend Credits.403Datei-Parsing ist für diesen Schlüssel oder dieses Konto nicht freigegeben.
Erweiterter Parser
POST /api/v2/resumes/extended-parser403Parser-Zugriff oder aktive Testphase erforderlich.422Das Dokument konnte nicht geparst werden.429Anfragelimit des erweiterten Parsers erreicht.
Formate, technische Limits und Kandidatendaten
Für die CV-Parsing-API werden derzeit folgende Formate genannt:
- DOCX
Der Standardendpunkt empfängt eine Datei als multipart/form-data; das cURL-Beispiel verwendet PDF. Die öffentliche API-Seite nennt PDF und DOCX. DOC und .txt-Dateien sind für diesen Endpunkt nicht bestätigt. Der erweiterte Endpunkt akzeptiert außerdem eine Textzeichenfolge im Feld text; das bestätigt keine Unterstützung für .txt-Dateien.
Vor der Integration zu prüfende Limits
- Dateigrößen- und Anfragelimits hängen vom Endpunkt ab.
- Planen Sie die Behandlung von HTTP-Fehlern und 429-Antworten bei erreichten Anfragelimits ein.
- Die API-Dokumentation ist maßgeblich für Parameter und Verhalten der einzelnen Endpunkte.
Was kostet CV-Parsing über die API?
Credits werden je CV entsprechend dem gewählten Parsing-Modus berechnet.
| Modus | Credits / CV | Bis zu so vielen CVs mit 200 Credits |
|---|---|---|
| Regelbasiertes Parsing | 1 | 200 |
| KI-Parsing 56 | 3 | 66 |
| KI-Parsing 96 | 5 | 40 |
Die Mengen setzen voraus, dass alle 200 Credits für einen Modus verwendet werden. Teilweise CVs werden nicht gezählt.
Die Testphase umfasst 200 Credits für 14 Tage, ohne Kreditkarte. Testen Sie repräsentative CVs, bevor Sie die vollständige Integration entwickeln.
Preise und Credits ansehenHäufige Fragen zur CV-Parsing-API
Wie integriere ich die Parsing-API in mein ATS?
Ihr Backend sendet den CV an die API, erhält die strukturierte Antwort und ordnet Eigenschaften den ATS-Feldern zu. Mapping und Oberfläche werden in Ihrer Software verwaltet.
Wie erhalte ich einen API-Schlüssel?
Erstellen Sie ein Konto und generieren Sie einen Schlüssel in Ihrem Bereich. Verwenden Sie den Header Authorization: ApiKey und bewahren Sie den privaten Schlüssel auf dem Server auf.
Welche CV-Formate kann ich senden?
Die öffentliche API-Seite nennt PDF und DOCX. Die Referenz zu POST /api/v2/resumes/parser verwendet ein multipart/form-data-Dateifeld und ein PDF-Beispiel; DOC oder .txt-Dateien werden nicht bestätigt. Der erweiterte Endpunkt akzeptiert eine Textzeichenfolge im Feld text, nicht zwingend eine TXT-Datei.
Welche Daten liefert die API zurück?
Je nach Parser kann die Antwort Kandidatendaten, Erfahrung, Ausbildung, Sprachen, Kompetenzen, Soft Skills, Referenzen, Social Links und weitere Schema-Eigenschaften enthalten.
Wie wähle ich zwischen Regeln, KI 56 und KI 96?
Regelbasiertes Parsing stellt 56 Felder für 1 Credit pro CV bereit. KI 56 nutzt 56 Felder für 3 Credits. KI 96 stellt 96 Felder für 5 Credits bereit, wenn mehr Details benötigt werden.
Werden alle verfügbaren Felder immer ausgefüllt?
Nein. Eine Schema-Eigenschaft wird nur ausgefüllt, wenn die Information im CV vorhanden und nutzbar ist. Ergebnisse hängen vom Dokument und Parser ab.
Wie erhalte ich das Parsing-Ergebnis?
Der Standardendpunkt gibt die Antwort auf die Anfrage zurück. Fordern Sie JSON mit Accept: application/json an; bestimmte asynchrone Abläufe nutzen die dokumentierten Webhooks.
Wie viele CVs kann ich mit 200 Credits testen?
Bis zu 200 CVs mit regelbasiertem Parsing, 66 mit KI 56 oder 40 mit KI 96, wenn alle Credits für einen Modus eingesetzt werden.
Sind während der Testphase alle Endpunkte verfügbar?
Der Zugriff hängt vom Endpunkt, API-Schlüssel und aktiven Tarif oder Test ab. Prüfen Sie die Bedingungen für den erweiterten Parser in der Dokumentation.
Ressourcen für Ihre Integration
Ein synthetisches Beispiel ansehen
Laden Sie die CV-Eingaben und erfassten API-Ausgaben herunter. Alle Personen, Unternehmen und Stellen sind fiktiv. Die Beispieldokumente sind auf Englisch; Ergebnisse hängen von Eingabe und Parser ab und müssen von Menschen geprüft werden.
Parsing-Antwort mit Ihren CVs testen
Prüfen Sie die zurückgegebenen Daten anhand repräsentativer Dokumente und ordnen Sie die Eigenschaften anschließend Ihrem ATS oder Ihrer HR-Software zu.
14 Tage Testphase · 200 Credits · keine Kreditkarte