Identité et coordonnées
Intitulé de poste, prénom, nom, adresse, ville, pays, téléphone et adresses e-mail disponibles.
API REST de parsing CV · intégration ATS et RH
Intégrez le parsing de CV à votre ATS via une API REST
Envoyez un CV à l’API REST CVReaderPro, récupérez une réponse structurée puis utilisez les données dans votre ATS, votre logiciel RH ou votre application métier.
14 jours d’essai · 200 crédits offerts · sans carte bancaire
Du document aux données
CV envoyé → données structurées → exploitation dans votre logiciel
CVReaderPro extrait les données du document. Votre backend reçoit la réponse et décide comment la mapper, l’enregistrer et l’afficher dans votre propre modèle candidat.
- 01
1. Envoyer le CV
Votre backend transmet le fichier au point d’entrée de parsing.
- 02
2. Choisir le parser
Sélectionnez le mode adapté au niveau de détail attendu et au document.
- 03
3. Recevoir les données
L’API renvoie les propriétés structurées dans une réponse JSON ou XML.
- 04
4. Exploiter le résultat
Votre application associe les champs retournés à son ATS, son CRM ou sa base candidats.
Quelles données pouvez-vous récupérer depuis un CV ?
Les propriétés retournées dépendent du parser choisi et des informations détectées dans le document.
Expériences professionnelles
Postes, entreprises, périodes, lieux, descriptions et indication d’un poste actuel.
Formations
Diplômes, établissements, dates et descriptions disponibles.
Compétences et langues
Compétences structurées, langues détectées et niveaux identifiables.
Profil et niveau d’expérience
Texte de profil, niveau d’expérience et niveau de formation selon la réponse du parser.
Autres propriétés
Soft skills, références, liens sociaux, loisirs et texte extrait lorsque le schéma les prévoit.
Les 56 ou 96 champs désignent les propriétés disponibles, pas des valeurs toujours renseignées. Une donnée absente ou inexploitable dans le CV peut rester vide.
Consulter les schémas complets dans la documentationExemple de réponse
Du CV aux données JSON structurées
À gauche, un CV PDF synthétique ; à droite, la réponse JSON IA 56 correspondante issue des exemples publics. Le bloc illustre les données qu’un ATS peut mapper dans son propre modèle candidat.
CV source synthétique
Alex Sample — ingénieur Java senior — Paris. Profil fictif utilisé pour illustrer le flux.
Télécharger le CV source (PDF)Les valeurs sont fictives. Les champs et contenus renseignés varient selon le document et le parser sélectionné.
Télécharger le fichier JSON complet{
"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"
}Démarrage technique
Effectuer un premier appel à l’API
Authentifiez la requête côté serveur, transmettez le CV en multipart/form-data, puis traitez la réponse structurée.
1. Créer une clé API
Générez la clé depuis votre compte et conservez-la côté serveur.
2. Envoyer le document
Appelez l’endpoint standard avec le fichier CV dans le champ file.
3. Choisir le mode
Le paramètre parserType est facultatif sur l’endpoint standard.
4. Traiter la réponse
Demandez application/json puis mappez les propriétés dans votre logiciel.
Exemple 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"Paramètres et parser étendu
Sur POST /api/v2/resumes/parser, BASIC active le parsing par règles (56 champs) et ADVANCED active l’IA 56 (56 champs). Pour IA 96, utilisez POST /api/v2/resumes/extended-parser : c’est un endpoint distinct, pas une valeur de parserType.
POST /api/v2/resumes/extended-parserLe parser étendu accepte un fichier ou un champ text dans une requête multipart. Envoyez exactement une de ces deux entrées ; vérifiez les droits requis dans la documentation.
Documentation APINe placez pas une clé API privée dans du JavaScript exécuté dans le navigateur. Consultez la documentation pour les paramètres, erreurs et contraintes de chaque endpoint.
Choisir le niveau de parsing pour votre intégration
Adaptez le moteur au niveau de contexte recherché et au coût de traitement par CV.
| Mode | Crédits / CV | Champs disponibles | Usage courant |
|---|---|---|---|
| Parsing par règles | 1 | 56 | Extraction standardisée pour structurer des volumes importants. |
| Parsing IA 56 | 3 | 56 | Interprétation IA lorsque le document demande davantage de contexte. |
| Parsing IA 96 | 5 | 96 | Parser étendu pour obtenir une représentation plus détaillée. |
Le parser IA 96 utilise un endpoint dédié : POST /api/v2/resumes/extended-parser. Il accepte un fichier ou du texte, une seule entrée par requête. L’accès peut dépendre de l’essai ou de l’offre associée à la clé API.
Le nombre de champs disponibles ne garantit pas que toutes les valeurs seront extraites du CV.
Découvrir le parsing CV par règlesConçu pour les équipes techniques
Intégrer le parsing dans votre ATS ou vos logiciels RH
CVReaderPro fournit le parsing et la réponse structurée. Votre application conserve la maîtrise du workflow et du modèle de données.
Éditeurs ATS
Ajoutez l’extraction de CV dans le parcours de réception des candidatures et mappez la réponse vers votre modèle candidat.
Logiciels RH
Transmettez les données utiles à vos fiches candidats et à vos workflows RH existants.
ESN et intégrations internes
Connectez le parsing à vos outils métier, portails candidats ou pipelines de traitement.
Équipes techniques
Traitez la réponse côté backend, gérez les erreurs et choisissez les données à afficher ou conserver.
L’API fournit les données structurées, pas un connecteur natif à chaque ATS. Le mapping, l’interface et les règles métier sont à développer ou configurer dans votre logiciel.
Réponses, erreurs et webhooks
Prévoyez le traitement des réponses réussies, des erreurs et des événements asynchrones dans votre intégration.
Parsing standard
POST /api/v2/resumes/parserPOST /api/v2/resumes/parser renvoie une réponse 200 en JSON ou XML selon l’en-tête Accept.
400Fichier CV invalide.401Clé API absente ou invalide.402Crédits insuffisants.403Parsing de fichier non autorisé pour la clé ou le compte.
Parser étendu
POST /api/v2/resumes/extended-parser403Accès au parser ou essai actif requis.422Document impossible à analyser.429Limite de requêtes du parser étendu atteinte.
Formats, limites techniques et données candidats
Les formats annoncés pour l’API de parsing CV sont :
- DOCX
L’endpoint standard reçoit un fichier via multipart/form-data et son exemple cURL utilise un PDF. La page API publique mentionne PDF et DOCX ; DOC et les fichiers TXT ne sont pas confirmés pour cet endpoint. L’endpoint étendu accepte aussi une chaîne dans le champ text, ce qui ne signifie pas qu’un fichier .txt est pris en charge.
Contraintes à vérifier avant l’intégration
- Les limites de taille et de fréquence dépendent de l’endpoint utilisé.
- Prévoyez le traitement des erreurs HTTP et des réponses 429 lorsque la limite de requêtes est atteinte.
- La documentation API reste la référence pour les paramètres et comportements propres à chaque endpoint.
Combien coûte le parsing CV via l’API ?
Les crédits sont décomptés par CV selon le mode de parsing choisi.
| Mode | Crédits / CV | Jusqu’à ce nombre de CV avec 200 crédits |
|---|---|---|
| Parsing par règles | 1 | 200 |
| Parsing IA 56 | 3 | 66 |
| Parsing IA 96 | 5 | 40 |
Ces volumes supposent que les 200 crédits soient entièrement consacrés à un seul mode. Les fractions de CV ne sont pas comptées.
L’essai comprend 200 crédits pendant 14 jours, sans carte bancaire. Testez des CV représentatifs avant de développer l’intégration complète.
Voir les tarifs et créditsQuestions fréquentes sur l’API de parsing CV
Comment intégrer l’API de parsing à mon ATS ?
Votre backend envoie le CV à l’API, récupère la réponse structurée puis associe les propriétés aux champs de votre ATS. Le mapping et l’interface sont gérés dans votre logiciel.
Comment obtenir une clé API ?
Créez votre compte puis générez une clé depuis votre espace. Utilisez l’en-tête Authorization: ApiKey et gardez la clé privée côté serveur.
Quels formats de CV puis-je envoyer ?
Le contenu public de la page API annonce PDF et DOCX. La référence de POST /api/v2/resumes/parser utilise un champ file en multipart/form-data et un exemple PDF ; elle ne confirme pas DOC ni les fichiers .txt. L’endpoint étendu accepte une chaîne de texte dans le champ text, pas nécessairement un fichier TXT.
Quelles données sont retournées ?
La réponse peut inclure les données candidat, expériences, formations, langues, compétences, soft skills, références, liens sociaux et d’autres propriétés prévues par le parser.
Comment choisir entre règles, IA 56 et IA 96 ?
Le mode par règles fournit 56 champs à 1 crédit par CV. IA 56 utilise aussi 56 champs à 3 crédits. IA 96 propose 96 champs à 5 crédits pour les intégrations nécessitant davantage de détails.
Les champs disponibles sont-ils toujours remplis ?
Non. Une propriété du schéma n’est renseignée que si l’information est présente et exploitable dans le CV. Le résultat varie selon le document et le parser.
Comment récupérer la réponse du parsing ?
L’endpoint standard renvoie la réponse à la requête. Demandez JSON avec l’en-tête Accept: application/json ; certains traitements asynchrones utilisent les webhooks documentés.
Combien de CV puis-je tester avec 200 crédits ?
Jusqu’à 200 CV avec le mode par règles, 66 avec IA 56 ou 40 avec IA 96 si tous les crédits sont consacrés à un seul mode.
Tous les endpoints sont-ils disponibles pendant l’essai ?
Les droits dépendent de l’endpoint, de la clé API et de l’offre ou de l’essai actif. Vérifiez les conditions du parser étendu dans la documentation.
Ressources pour votre intégration
Explorer un exemple synthétique
Téléchargez les CV sources et les sorties API enregistrées. Les personnes, entreprises et offres sont fictives. Les documents exemples sont en anglais ; les résultats dépendent du document et du parser et nécessitent une revue humaine.
Testez la réponse de parsing avec vos CV
Vérifiez les données retournées sur des documents représentatifs, puis mappez les propriétés dans votre ATS ou votre logiciel RH.
14 jours d’essai · 200 crédits offerts · sans carte bancaire