AI APIs para constructores de ATS
On this page
Esta página es para equipos de producto e ingeniería que desarrollan software de reclutamiento. Curriculo convierte los CV, los requisitos de trabajo y las entrevistas en datos estructurados y listos para la toma de decisiones. Envía un documento o una grabación; obtiene campos limpios, una puntuación de ajuste, una traducción, una transcripción o un resumen de contratación.
El API no es otro panel de control que los usuarios deben iniciar sesión. Su producto mantiene los registros de los candidatos, el flujo de trabajo de la vacante y el flujo de trabajo del reclutador UI. Curriculo realiza el trabajo de análisis de datos, idioma y medios detrás de él, a través de una sola clave desde la Consola de desarrolladores .
Qué hace el API
| Capacidad | Qué envía | Qué obtiene a cambio |
|---|---|---|
| Analizar CV | Uno o más CV (PDF o DOCX) en una sola solicitud. | El currículum completo como datos limpios y estructurados: nombre, datos de contacto, historial laboral, educación, habilidades. Los valores permanecen en el idioma y el guion propio de CV. |
| Evaluar al candidato | Uno o más currículums (PDF o DOCX) y el trabajo, como texto, un documento o un registro job_id. | Una puntuación de idoneidad con razonamiento escrito, habilidades coincidentes, brechas y puntos resumidos, para cada CV. |
| Traducir | Hasta 200 cadenas, o PDF y DOCX documentos. | Traducciones en el orden en que se enviaron, a cualquiera de 85 idiomas. Un elemento fallido nunca colapsa el lote. |
| Detectar idioma | Un texto, o hasta 200. | El idioma de cada uno, para que pueda enrutar un CV o mensaje antes de actuar sobre él. |
| Resumen de la entrevista | Una transcripción, un documento de transcripción (PDF o DOCX), o una grabación (vídeo o audio). | Aspectos destacados, señales de alerta, habilidades mencionadas y una recomendación con justificación. Las grabaciones se devuelven con su transcripción. |
| Transcribir | Una grabación. | Solo la transcripción. |
| Asistente de currículum | Un CV una vez, luego instrucciones en lenguaje plano. | Un currículum funcional que se puede cuestionar, editar o renderizar en otro idioma sin volver a subir. |
| Entrevista de selección | Correos electrónicos de los candidatos, preguntas y su número de devolución URL. | Curriculo envía correos electrónicos a cada candidato, hospeda la entrevista grabada, transcribe cada respuesta y la publica, firmada, en su servidor. |
Grandes atrasos y grabaciones largas se ejecutan como tareas en segundo plano : envíe enlaces o subidas, obtenga un task_id de inmediato y recopile el resultado mediante sondeo o mediante llamada de retorno firmada.
El API no es un segundo ATS.
POST /jobs/almacena un trabajo solo como una descripción para evaluar los CV contra él. No hay lista, no paginación, no organización y no pipeline.
Integración de ejemplo ATS
| Paso | Su sistema | Curriculo |
|---|---|---|
| 1. Contexto del trabajo | Almacena el trabajo y lo registra una vez con POST /jobs/ (gratis) o envía job_details en línea. | Lo utiliza para evaluar a los candidatos. |
| 2. Ingesta | Envía los CV a /parse/ y /evaluate/, o enlaza a /parse/async y /evaluate/async para un backlog. | Devuelve los CV estructurados y las evaluaciones, en orden. |
| 3. Selección | Llama llamadas POST /screening-interview con correos electrónicos de candidatos, preguntas y un callback_url. | Envía invitaciones, hospeda la grabación, transcribe respuestas. |
| 4. Resultados | Verifica X-Curriculo-Signature, luego almacena transcripciones, evaluaciones y enlaces de grabación. | Envía resultados firmados a medida que los candidatos terminan. |
| 5. Entrevistas | Envía grabaciones o transcripciones a /summary/. | Devuelve destacados, señales de alerta y una recomendación. |
Multilingüe por defecto
- Envíe CV en cualquier idioma. El análisis y la evaluación leen el documento tal como está escrito, sin preprocesamiento por su parte.
- Nada se reescribe silenciosamente. Los valores analizados se devuelven en el idioma y el guión propios de CV.
- Elija el idioma de salida. La evaluación, los resúmenes de entrevistas y el asistente de currículum cada uno acepta una configuración
language. - Detecta antes de enrutar. Ramifica un flujo de trabajo antes de que cualquier persona lea el documento.
Ver Idiomas.
Empezar
- Crea tu cuenta en la consola .curriculo.me. El registro es autoservicio y un crédito gratuito de $5.00 cubre tus primeras llamadas.
- Genera una clave API en la página de claves API claves . Funciona de inmediato para cada operación. La clave se muestra una sola vez, así que guárdala en un lugar seguro.
- Prueba cada capacidad desde la documentación interactiva con un archivo real CV o transcripción.
- Entrega la clave a tu equipo de ingeniería. Cada capacidad es una sola solicitud, así que la integración es pequeña y autosuficiente.
El recorrido completo está en el Inicio rápido.
Volumen, velocidad y límites
Consulte Límites de velocidad y Procesamiento por lotes.
Qué esperar operativamente
- Cada solicitud es independiente. Un documento que falla nunca afecta a otro, y reenviar un documento fallido siempre es seguro.
- Los errores son explícitos. Una solicitud rechazada indica el motivo. Consulte Errores.
- Las solicitudes fallidas no se cobran. Tampoco se cobran las tareas de fondo fallidas ni las invitaciones de selección fallidas.
- El uso es visible por clave. Emite claves separadas para entornos o equipos separados.
- Conozca qué se almacena. Las llamadas de análisis, evaluación, traducción, detección de idioma, resumen y transcripción sincrónicas no almacenan nada. Los trabajos registrados, el asistente de currículum, las tareas de fondo y las entrevistas de selección almacenan datos. Consulte Manejo de datos.
Facturación
Prepago y por solicitud, sin suscripción: $0.01 para la mayoría de las operaciones, $0.001 para la detección de idioma, $0.002 por minuto de audio para grabaciones, y $0.02 por invitación de selección enviada. Una lista de currículums en una solicitud es un solo cargo. Tabla completa en Precios y facturación.
Curriculo dentro de su AI asistente
Separadamente del API, los equipos en Curriculo ATS pueden trabajar su pipeline de contratación desde Claude, ChatGPT, Cursor y otros clientes. Es un producto diferente con su propio inicio de sesión, y una clave API no alcanza sus herramientas. Consulte la documentación MCP.
Updated