Évaluer un candidat

POSThttps://api.curriculo.me/public/evaluate/

On this page

Une demande
Exemples
Réponse
Le calendrier
Les erreurs

Il n'y a pas d'État. Marque les CV par rapport à un emploi et rend, pour chaque CV, un score d'adéquation avec un raisonnement écrit, des compétences correspondantes, des lacunes et des points de résumé. Chaque CV est évalué individuellement par rapport au même travail.

Prix: $ 0.01 par demande, qu'il porte un CV ou dix.

Une demande

multipart/form-data

champs	Type	Notes
`resume_pdfs`	fichier[]	Un à 10 CV, PDF ou DOCX (indépendamment du nom du champ), 10 MB chacun. Chaque CV est évalué par rapport au même travail.
`resume_pdf`	fichier	Nom de code unique. PDF ou DOCX.
`job_details`	la chaîne	Le travail en tant que texte ordinaire collé de votre page de carrière, ou un objet JSON si vous avez des exigences structurées.
`job_file`	fichier	La description de l'emploi en tant que PDF ou DOCX.
`job_id`	la chaîne	Un emploi enregistré plus tôt via `POST /jobs/`, envoyé au lieu de répéter la description sur un backlog.
`language`	la chaîne	Le code ISO 639-1 pour la prose du candidat. Vacu signifie anglais.

Donnez le travail exactement d' une manière: job_details,job_file ou job_id. Envoyer la description en ligne fonctionne toujours. Enregistrer un emploi en premier est une optimisation, jamais une étape requise.

Exemples

Description du poste en ligne:

curl -X POST https://api.curriculo.me/public/evaluate/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -F '[email protected]' \
  -F 'job_details=Senior backend engineer, Python and FastAPI, Seoul'

Une liste de CV sur un emploi enregistré:

curl -X POST https://api.curriculo.me/public/evaluate/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -F 'resume_pdfs=@candidate_a.pdf' \
  -F 'resume_pdfs=@candidate_b.pdf' \
  -F 'job_id=job_abc123'

Réponse

Un CV renvoie l'objet d'évaluation du CV. Plusieurs CV renvoient un tableau results , une entrée par CV, dans l'ordre des entrées. Voir Batchage.

Le calendrier

30 à 60 secondes par évaluation. Gardez le temps de votre client au-dessus de cinq minutes. Pour un backlog, utilisez POST /evaluate/async avec jusqu'à 25 liens par tâche.

Les erreurs

Le statut	Cause typique
`400`	Non lisible CV ou malformé `job_details`.
`404`	`job_id`inconnu , ou un enregistré par un compte différent. Registrez le travail à nouveau.
`413`	Un CV au-dessus de 10 MB, plus de 10 CV ou un organisme de demande au-dessus de 12 MB.
`422`	Un champ requis est manquant ou mal nommé.
`504`	Le traitement a dépassé 300 secondes. Envoyez moins de CV par demande.

Updated 12 October 2026