Evaluar a un candidato

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

On this page

Solicitud
Ejemplos
Respuesta
Tiempo
Errores

Sin estado. Puntuación de CVs contra un trabajo y devuelve, para cada CV, una puntuación de idoneidad con razonamiento escrito, habilidades coincidentes, brechas y puntos resumidos. Cada CV se evalúa individualmente contra el mismo trabajo.

Precio: $0.01 por solicitud, ya sea que contenga un CV o diez.

Solicitud

multipart/form-data

Campo	Tipo	Notas
`resume_pdfs`	archivo[]	De 1 a 10 CV, PDF o DOCX (a pesar del nombre del campo), 10 MB cada uno. Cada CV se evalúa contra el mismo puesto.
`resume_pdf`	archivo	Alias de documento único. PDF o DOCX.
`job_details`	cadena	El trabajo como texto plano pegado desde tu página de carreras, o un objeto JSON si tienes requisitos estructurados.
`job_file`	archivo	La descripción del trabajo como un PDF o un DOCX.
`job_id`	cadena	Un trabajo registrado anteriormente a través de `POST /jobs/`, enviado en lugar de repetir la descripción en un backlog.
`language`	cadena	Código 639-1 de ISO para la prosa orientada al candidato. Vacío significa inglés.

Proporcionar el trabajo de exactamente una manera: job_details,job_file o job_id. Enviar la descripción en línea siempre funciona. Registrar un trabajo primero es una optimización, nunca un paso requerido.

Ejemplos

Descripción del trabajo en línea:

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'

Una lista de CVs contra un trabajo registrado:

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'

Respuesta

Un CV devuelve el objeto de evaluación de CV. Varios CVs devuelven una matriz results , una entrada por CV, en orden de entrada. Ver Procesamiento por lotes.

Tiempo

30 a 60 segundos por evaluación. Mantenga el tiempo de espera del cliente por encima de cinco minutos. Para un backlog, use POST /evaluate/async con hasta 25 enlaces por tarea.

Errores

Estado	Causa típica
`400`	Archivo CV ilegible o con formato incorrecto `job_details`.
`404`	`job_id`desconocido, o registrado por una cuenta diferente. Registre el trabajo de nuevo.
`413`	Un CV superior a 10 MB, más de 10 CV, o un cuerpo de solicitud que supere los 12 MB.
`422`	Falta un campo obligatorio o está mal nombrado.
`504`	El procesamiento superó los 300 segundos. Envíe menos CV por solicitud.

Updated 12 October 2026