API AI pour les constructeurs de ATS
Sur cette page
Cette page est destinée aux équipes de produits et d'ingénierie qui construisent des logiciels de recrutement. Le Curriculo API transforme les CV, les exigences professionnelles et les entrevues en données structurées et prêtes à prendre des décisions. Vous envoyez un document ou un enregistrement; vous récupérez des champs propres, une note en forme, une traduction, une transcription ou un sommaire de l'embauche.
Le API n'est pas un autre tableau de bord auquel vos utilisateurs doivent se connecter. Votre produit conserve les dossiers des candidats, le workflow de travail et le recruteur UI. Le Curriculo API fait travailler le AI, la langue et les médias derrière, à travers une clé de la console de développeurs .
Quel Curriculo API devrait utiliser mon ATS?
Utilisez parse pour transformer les CV entrants en enregistrements de candidats structurés, évaluer pour les marquer par rapport à un travail, traduire et détecter la langue pour les pipelines multilingues, et résumé ou transcrire pour les enregistrements d'entrevue. Votre ATS garde les candidats, les emplois et les écrans de recrutement; le Curriculo API fait travailler le document, la langue et les médias derrière eux, avec une seule clé.
Ce que fait le API
| Capacité | Ce que vous envoyez | Ce que tu récupères |
|---|---|---|
| Analyser CV | Un ou plusieurs CV (PDF ou DOCX) en une seule demande. | Le curriculum vitae complet comme des données propres et structurées : nom, coordonnées, histoire du travail, éducation, compétences. Les valeurs restent dans la langue et le script du CV. |
| Évaluer le candidat | Un ou plusieurs CV (PDF ou DOCX) et l'emploi, comme texte, un document ou un enregistrement job_id. | Une note d'aptitude avec raisonnement écrit, compétences appariées, lacunes et points sommaires, pour chaque CV. |
| Traduire | Jusqu'à 200 chaînes ou documents PDF et DOCX. | Traductions dans l'ordre que vous leur avez envoyé, dans l'une des 202 langues. Un élément échoué ne s'effondre jamais le lot. |
| Détecter le langage | Un SMS, ou jusqu'à 200. | La langue de chacun, de sorte que vous pouvez router un CV ou un message avant d'agir sur elle. |
| Résumé de l'entrevue | Une transcription, un document de transcription (PDF ou DOCX), ou un enregistrement (vidéo ou audio). | Faits saillants, drapeaux rouges, compétences mentionnées, et une recommandation avec raisonnement. Les enregistrements reviennent avec leur transcription. |
| Transcription | Un enregistrement. | La transcription seulement. |
| Assistant au curriculum vitae | Un CV une fois, puis des instructions en langage simple. | Un CV de travail vous permet de questionner, de modifier ou de rendre dans une autre langue sans recharger. |
| Entretien de sélection | Les courriels, les questions et votre rappel URL. | Curriculo envoie par e-mail chaque candidat, héberge l'entrevue enregistrée, transcrit chaque réponse et POST, signé, à votre serveur. |
De grands retards et de longs enregistrements s'exécutent comme tâches de fond : envoyer des liens ou des téléchargements, obtenir un task_id à la fois, et recueillir le résultat par sondage ou par rappel signé.
Le API n'est pas un second ATS.
POST /jobs/ne stocke un travail que comme une description pour évaluer les CV par rapport. Il n'y a ni liste, ni pagination, ni organisation, ni pipeline.
Exemple d'intégration ATS
| Étape | Votre système | Curriculo |
|---|---|---|
| 1. Contexte de l'emploi | Stocke le travail, et l'enregistre une fois avec POST /jobs/ (gratuit) ou envoie job_details en ligne. | Il l'utilise pour marquer les candidats. |
| 2. Prise | Envoie des CV à /parse/ et /evaluate/, ou des liens vers /parse/async et /evaluate/async pour un arriéré. | Retourne les CV structurés et les évaluations, dans l'ordre. |
| 3. Examen préalable | Appels POST /screening-interview avec courriels, questions et un candidat callback_url. | Envoie des invitations, héberge l'enregistrement, transcrit les réponses. |
| 4. Résultats | Vérifie X-Curriculo-Signature, puis stocke les transcriptions, les évaluations et les liens d'enregistrement. | Les résultats des POST ont été signés lorsque les candidats ont terminé. |
| 5. Entretiens | Envoie des enregistrements ou transcriptions à /summary/. | Retourne les points forts, les drapeaux rouges et une recommandation. |
Multilingue par défaut
- Envoyez des CV dans n'importe quelle langue. L'analyse et l'évaluation lisent le document tel qu'écrit, sans pré-traitement de votre côté.
- Rien n'est réécrit en silence. Les valeurs parsées reviennent dans la langue et le script du CV.
- Choisissez le langage de sortie. Évaluation, résumés d'entrevue et l'assistant du curriculum vitae acceptent chacun un réglage
language. - Détectez avant de vous diriger. Branche un workflow avant que n'importe quel humain ne lit le document.
Commencer
- Créez votre compte sur la console .curriculo.me. S'inscrire est libre-service, et un crédit gratuit de $5.00 couvre vos premiers appels.
- Générer une clé API sur la page API clés . Il fonctionne immédiatement pour chaque opération. La clé est montrée une fois, alors gardez-la quelque part en sécurité.
- Essayez chaque capacité à partir de la référence API avec une vraie CV ou une transcription.
- Donnez la clé à votre équipe d'ingénieurs. Chaque capacité est une seule demande, donc l'intégration est petite et autonome.
Le tour complet est dans le Quickstart.
Volume, vitesse et limites
| Quoi ? | Valeur | Pourquoi ça compte ? |
|---|---|---|
| Taille du document | Jusqu'à 10 MB | Couvre essentiellement tous les CV, y compris les CV scannés et les CV. |
| Temps de traitement de CV | Environ 10 à 90 secondes | Analyse AI réelle, pas de correspondance de mots-clés. Traitez-le comme un travail de fond, pas comme une charge de page. |
| Débit | Environ 2 à 4 CV par minute | Une estimation. Le travail intensif comporte trois opérations à la fois sur la capacité partagée dans l'ensemble du service, de sorte que le débit varie en fonction de la charge. |
| Traduction en un seul appel | 200 cordes, 50 000 caractères | Une page complète de carrière ou CV en une seule demande. |
| Transcriptions des entretiens | 200 000 caractères | Confortablement convient à une longue entrevue de panel, in extenso. |
| Enregistrements | Jusqu'à 100 MB sur un chargement /summary/ synchrone; jusqu'à 1 GB ou 2 heures par lien | De longues entrevues passent par la voie async. |
| Taux de demande | 600 demandes par minute, par clé | Le dépasser revient 429. |
Voir Limites de taux et Battching.
À quoi s'attendre sur le plan opérationnel?
- Chaque demande est individuelle. Un document défaillant n'affecte jamais un autre document, et la réenvoi d'un document défaillant est toujours sécuritaire.
- Les erreurs sont explicites. Une demande rejetée vous explique pourquoi. Voir les erreurs .
- Les demandes rejetées ne sont pas facturées. Ni les tâches d'arrière-plan ni les invitations à la présélection qui ont échoué ne sont pas terminées.
- L'utilisation est visible par clé. Émettre des clés séparées pour des environnements ou des équipes séparés.
- Savoir ce qui est stocké. Analyser, évaluer, traduire, détecter le langage, résumer et transcrire les appels en synchrone ne contiennent rien au-delà des courts extraits enregistrés lorsqu'un appel AI échoue. Les emplois enregistrés, l'assistant au curriculum vitae, les tâches de base et les entrevues de sélection conservent les données. Voir Traitement des données.
Facturation
Prépayé et par demande, sans abonnement : $0.01 pour la plupart des opérations (par CV ou document pour les listes), $0.001 pour la détection de la langue, environ $0.002 par minute d'audio pour les enregistrements, et $0.02 par invitation de projection envoyée. Tableau complet en Tarifs et facturation.
Curriculo à l'intérieur de votre assistant AI
En dehors du API, les équipes du Curriculo ATS peuvent travailler leur pipeline d'embauche de Claude, ChatGPT, Cursor et d'autres clients. Il s'agit d'un produit différent avec sa propre connexion, et une clé API n'atteint pas ses outils. Voir la documentation MCP.
FAQ
Mon utilisateur ATS a-t-il besoin d'une connexion Curriculo ?
C'est pas vrai. Votre produit appelle le Curriculo API avec une clé de la Console Développeur. Vos utilisateurs ne se connectent jamais à Curriculo.
Les données des candidats sont-elles stockées?
Pas par les opérations synchrones, à part les courts extraits enregistrés lorsqu'un appel AI échoue. Les tâches de fond, les emplois enregistrés, les curriculum vitæ enregistrés et les entrevues de sélection conservent les données; voir Gestion des données.
Puis-je envoyer des CV dans n'importe quelle langue?
Oui. Les valeurs parsées restent dans la langue et le script du CV, et la traduction couvre 202 langues.
Mis à jour le