Vai al contenuto principale

API REST di parsing CV · integrazione ATS e HR

Integra il parsing CV nel tuo ATS tramite un’API REST

Invia un CV all’API REST di CVReaderPro, ricevi una risposta strutturata e usa i dati nel tuo ATS, software HR o applicazione aziendale.

Prova l’API con un CVDocumentazione APIParliamo dell’integrazione

Prova di 14 giorni · 200 crediti · senza carta di credito

Dal documento ai dati

CV inviato → dati strutturati → utilizzo nel software

CVReaderPro estrae i dati dal documento. Il tuo backend riceve la risposta e decide come associarla, salvarla e mostrarla nel proprio modello candidato.

  1. 01

    1. Inviare il CV

    Il backend trasmette il file a un endpoint di parsing.

  2. 02

    2. Scegliere il parser

    Seleziona la modalità in base al documento e al dettaglio richiesto.

  3. 03

    3. Ricevere i dati

    L’API restituisce proprietà strutturate in una risposta JSON o XML.

  4. 04

    4. Usare il risultato

    L’applicazione associa i campi all’ATS, al CRM o al database candidati.

Quali dati si possono recuperare da un CV?

Le proprietà restituite dipendono dal parser scelto e dalle informazioni rilevate nel documento.

Identità e contatti

Ruolo, nome, cognome, indirizzo, città, paese, telefono ed e-mail disponibili.

Esperienza professionale

Ruoli, aziende, periodi, località, descrizioni e indicazione di posizione attuale.

Formazione

Titoli di studio, istituti, date e descrizioni disponibili.

Competenze e lingue

Competenze strutturate, lingue rilevate e livelli identificabili.

Profilo e livello di esperienza

Testo del profilo, livello di esperienza e formazione se restituiti dal parser.

Altre proprietà

Soft skill, referenze, link social, hobby e testo estratto quando previsti dallo schema.

56 o 96 campi indicano proprietà disponibili, non valori sempre compilati. Le informazioni assenti o non utilizzabili nel CV possono restare vuote.

Consulta gli schemi completi nella documentazione

Esempio di risposta

Dal CV al JSON strutturato

A sinistra c’è un CV PDF sintetico; a destra la relativa risposta JSON IA 56 inclusa negli esempi pubblici. Il blocco mostra i dati che un ATS può associare al proprio modello candidato.

CV sorgente sintetico

Alex Sample — Senior Java Engineer — Parigi. Profilo fittizio usato per illustrare il flusso.

Scarica il CV sorgente (PDF)

I valori sono fittizi. Campi e contenuti compilati variano in base al CV e al parser scelto.

Scarica il file JSON completo
Risposta JSON · parser IA 56
{
  "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"
}

Avvio tecnico

Effettua la prima chiamata API

Autentica la richiesta dal server, invia il CV come multipart/form-data e gestisci la risposta strutturata.

  1. 1. Crea una chiave API

    Genera una chiave nel tuo account e conservala sul server.

  2. 2. Invia il documento

    Chiama l’endpoint standard con il file CV nel campo file.

  3. 3. Scegli la modalità

    Il parametro parserType è facoltativo nell’endpoint standard.

  4. 4. Gestisci la risposta

    Richiedi application/json e associa le proprietà nel tuo software.

Esempio cURL

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"

Opzioni parser ed endpoint esteso

Su POST /api/v2/resumes/parser, BASIC seleziona il parsing basato su regole (56 campi) e ADVANCED seleziona IA 56 (56 campi). Per IA 96 usa POST /api/v2/resumes/extended-parser: è un endpoint separato, non un valore parserType dell’endpoint standard.

POST /api/v2/resumes/extended-parser

Il parser esteso accetta un file oppure un campo text in una richiesta multipart. Invia una sola delle due voci e verifica i requisiti di accesso nella documentazione.

Documentazione API

Non esporre una chiave API privata nel JavaScript eseguito dal browser. Consulta la documentazione per parametri, errori e limiti di ogni endpoint.

Scegli il livello di parsing per l’integrazione

Adatta il parser al contesto richiesto e al costo di elaborazione per CV.

Scegli il livello di parsing per l’integrazione
ModalitàCrediti / CVCampi disponibiliUso tipico
Parsing a regole156Estrazione standardizzata per gestire grandi volumi di CV.
Parsing IA 56356Interpretazione IA quando il documento richiede più contesto.
Parsing IA 96596Parser esteso per una rappresentazione più dettagliata.

IA 96 utilizza un endpoint dedicato: POST /api/v2/resumes/extended-parser. Accetta un file o un input di testo, uno per richiesta. L’accesso può dipendere da una prova attiva o dal piano associato alla chiave API.

Il numero di campi disponibili non garantisce l’estrazione di tutti i valori dal CV.

Scopri il parsing CV a regole

Per i team tecnici

Integra il parsing nel tuo ATS o software HR

CVReaderPro fornisce il parsing e i dati strutturati. La tua applicazione mantiene il controllo del workflow e del modello dati.

Fornitori di ATS

Aggiungi l’estrazione CV al flusso delle candidature e associa la risposta al tuo modello candidato.

Software HR

Invia i dati utili alle schede candidato e ai flussi HR esistenti.

Società IT e integrazioni interne

Collega il parsing a strumenti aziendali, portali candidati o pipeline di elaborazione.

Team tecnici

Gestisci la risposta dal backend, gli errori e i dati da mostrare o conservare.

L’API fornisce dati strutturati, non un connettore nativo per ogni ATS. Mapping, interfaccia e regole aziendali vanno implementati o configurati nel tuo software.

Risposte, errori e webhook

Prevedi la gestione di risposte corrette, errori ed eventi asincroni nella tua integrazione.

Parsing standard

POST /api/v2/resumes/parser

POST /api/v2/resumes/parser restituisce HTTP 200 in JSON o XML in base all’header Accept.

  • 400File CV non valido.
  • 401Chiave API assente o non valida.
  • 402Crediti insufficienti.
  • 403Parsing dei file non autorizzato per la chiave o l’account.

Parser esteso

POST /api/v2/resumes/extended-parser
  • 403È necessario l’accesso al parser o una prova attiva.
  • 422Documento non analizzabile.
  • 429Limite di richieste del parser esteso raggiunto.

Formati, limiti tecnici e dati dei candidati

I formati indicati attualmente per l’API di parsing CV sono:

  • PDF
  • DOCX

L’endpoint standard riceve un file in multipart/form-data e l’esempio cURL usa un PDF. La pagina API pubblica menziona PDF e DOCX; DOC e file .txt non sono confermati per questo endpoint. L’endpoint esteso accetta anche una stringa di testo nel campo text, ma ciò non conferma il supporto per file .txt.

Limiti da verificare prima dell’integrazione

  • I limiti di dimensione dei file e di frequenza delle richieste dipendono dall’endpoint.
  • Prevedi la gestione degli errori HTTP e delle risposte 429 in caso di limite raggiunto.
  • La documentazione API è il riferimento per parametri e comportamento dei singoli endpoint.

Quanto costa il parsing CV tramite API?

I crediti vengono addebitati per CV secondo la modalità di parsing scelta.

Quanto costa il parsing CV tramite API?
ModalitàCrediti / CVFino a questo numero di CV con 200 crediti
Parsing a regole1200
Parsing IA 56366
Parsing IA 96540

I volumi presuppongono che tutti i 200 crediti siano dedicati a una sola modalità. Le frazioni di CV non vengono conteggiate.

La prova include 200 crediti per 14 giorni, senza carta di credito. Prova CV rappresentativi prima di sviluppare l’integrazione completa.

Vedi prezzi e crediti

Domande frequenti sull’API di parsing CV

Come integro l’API di parsing nel mio ATS?

Il backend invia il CV all’API, riceve la risposta strutturata e associa le proprietà ai campi ATS. Mapping e interfaccia vengono gestiti nel tuo software.

Come ottengo una chiave API?

Crea un account e genera una chiave dalla tua area. Usa l’header Authorization: ApiKey e conserva la chiave privata sul server.

Quali formati CV posso inviare?

La pagina API pubblica indica PDF e DOCX. La documentazione di POST /api/v2/resumes/parser usa un campo file multipart/form-data e un esempio PDF; non conferma DOC né file .txt. L’endpoint esteso accetta una stringa di testo nel campo text, non necessariamente un file TXT.

Quali dati restituisce l’API?

In base al parser, la risposta può includere dati candidato, esperienze, formazione, lingue, competenze, soft skill, referenze, link social e altre proprietà dello schema.

Come scelgo tra regole, IA 56 e IA 96?

Il parsing a regole offre 56 campi per 1 credito per CV. IA 56 usa 56 campi per 3 crediti. IA 96 offre 96 campi per 5 crediti quando servono più dettagli.

I campi disponibili vengono sempre compilati?

No. Una proprietà viene compilata solo se l’informazione è presente e utilizzabile nel CV. Il risultato varia in base al documento e al parser.

Come ricevo il risultato del parsing?

L’endpoint standard restituisce la risposta alla richiesta. Richiedi JSON con l’header Accept: application/json; alcuni flussi asincroni usano i webhook documentati.

Quanti CV posso provare con 200 crediti?

Fino a 200 CV con il parsing a regole, 66 con IA 56 o 40 con IA 96 se tutti i crediti sono destinati a una sola modalità.

Tutti gli endpoint sono disponibili durante la prova?

L’accesso dipende dall’endpoint, dalla chiave API e dal piano o dalla prova attiva. Verifica nella documentazione i requisiti del parser esteso.

Risorse per l’integrazione

Esplora un esempio sintetico

Scarica i CV di input e gli output API acquisiti. Tutte le persone, aziende e offerte sono fittizie. I documenti di esempio sono in inglese; i risultati dipendono dal documento e dal parser e richiedono una revisione umana.

CV di esempio (PDF)Risultato Rule-Based (JSON)CV di esempio IA (PDF)Risultato IA 56 (JSON)

Prova la risposta di parsing con i tuoi CV

Verifica i dati restituiti su documenti rappresentativi, poi associa le proprietà al tuo ATS o software HR.

Prova l’API con un CVDocumentazione APIParliamo dell’integrazione

Prova di 14 giorni · 200 crediti · senza carta di credito