APIs de AI para desarrolladores de ATS
En esta página
Esta página es para equipos de producto e ingeniería que desarrollan software de reclutamiento. El Curriculo API convierte los CVs, los requisitos del puesto y las entrevistas en datos estructurados listos para la toma de decisiones. Envías un documento o una grabación; recibes 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 en el que sus usuarios deben iniciar sesión. Tu producto mantiene registros de candidatos, el flujo de trabajo y el reclutador UI. El Curriculo API realiza el AI, el trabajo de idioma y medios detrás, a través de una clave desde la Consola de Desarrolladores de .
¿Qué Curriculo API debería usar mi ATS?
Utiliza para analizar , convirtiendo los CVs entrantes en registros estructurados de candidatos, evaluándolos para puntuarlos según un puesto de trabajo, traducir y detectar idiomas para flujos de trabajo multilingües, así como resumir o transcribir grabaciones de entrevistas. Tu ATS mantiene las pantallas de candidatos, empleos y reclutadores; el Curriculo y el API realizan el trabajo de documentos, idiomas y medios detrás de ellos, con una clave.
Lo que hace el API
| Capacidad | Lo que envías | Lo que obtienes de vuelta |
|---|---|---|
| Analizar CV | Uno o más CVs (PDF o DOCX) en una sola solicitud. | El currículum completo como datos estructurados y limpios: nombre, datos de contacto, experiencia laboral, formación académica y habilidades. Los valores permanecen en el propio idioma y escritura de CV. |
| Evaluar al candidato | Uno o más CVs (PDF o DOCX) y el puesto de trabajo, como texto, un documento o registrado job_id. | Una puntuación de idoneidad con razonamiento escrito, habilidades coincidentes, lagunas y puntos resumidos para cada CV. |
| Traducir | Hasta 200 cadenas, o documentos PDF y DOCX. | Traduce del inglés al español. Solo produce la traducción, nada más. Las traducciones en el orden en que las enviaste, a cualquiera de los 202 idiomas. Un artículo defectuoso nunca hace colapsar el lote. |
| Detectar idioma | Un texto, o hasta 200. | El idioma de cada uno, para que puedas 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). | Destacados, señales de alerta, habilidades mencionadas y una recomendación con razonamiento. Las grabaciones regresan con su transcripción. |
| Transcribir | Una grabación. | Solo la transcripción. |
| Resumen asistente | Un CV una vez, luego instrucciones en lenguaje sencillo. | Un currículum funcional que puedes cuestionar, editar o traducir a otro idioma sin volver a subir. |
| Entrevista de selección | Correos electrónicos de los candidatos, preguntas y su devolución de llamada URL. | Curriculo envía un correo electrónico a cada candidato, aloja la entrevista grabada, transcribe cada respuesta y la POSTea firmada a tu servidor. |
Grandes retrasos y grabaciones largas se ejecutan como tareas en segundo plano: envía enlaces o subidas, recibe un task_id a la vez, y recopilar el resultado mediante sondeo o una firma de devolución de llamada.
El API no es un segundo ATS.
POST /jobs/almacena un puesto de trabajo únicamente como una descripción para evaluar los currículos en función de ella. No hay listado, ni paginación, ni organización ni canal.
Integración de ATS
| Paso | Tu sistema | Curriculo |
|---|---|---|
| 1. Contexto laboral | Almacena el trabajo y lo registra una vez con POST /jobs/ (gratis) o envía job_details en línea. | Lo utiliza para puntuar a los candidatos. |
| 2. Entrada | Envía los CVs a /parse/ y /evaluate/, o enlaces a /parse/async y /evaluate/async para una acumulación. | Devuelve currículums estructurados y evaluaciones, en orden. |
| 3. Selección | Llama a POST /screening-interview con correos electrónicos de candidatos, preguntas y un callback_url. | Envía invitaciones, organiza la grabación y transcribe las respuestas. |
| 4. Resultados | Verifica X-Curriculo-Signature, luego almacena transcripciones, evaluaciones y enlaces de grabación. | Los resultados firmados se publican a medida que los candidatos finalizan. |
| 5. Entrevistas | Envía grabaciones o transcripciones a /summary/. | Devuelve destacados, señales de alerta y una recomendación. |
Multilingüe por defecto
- Enviar CVs en cualquier idioma. La lectura y evaluación del documento se realiza tal como está escrito, sin ningún preprocesamiento por su parte.
- Nada se reescribe en silencio. Los valores analizados de se devuelven en el propio idioma y sistema de escritura de CV.
- Elija el idioma de salida. Evaluación, resúmenes de entrevistas y el asistente de currículum aceptan cada uno una configuración
language. - Detecta antes de enrutar. Rama un flujo de trabajo antes de que cualquier persona lea el documento.
Ver Idiomas.
Comenzar
- Crea tu cuenta en la consola . .mecurriculo.. El registro es por cuenta propia, y un crédito gratuito de $5.00 cubre tus primeras llamadas.
- Generar una clave API sobre el Claves API página. Funciona de inmediato para cada operación. La clave se muestra una vez, así que guárdela en un lugar seguro.
- Prueba cada capacidad de Referencia API con un CV real o transcripción.
- Entrega la clave a tu equipo de ingeniería. Cada capacidad es una única solicitud, por lo que la integración es pequeña y autocontenida.
La guía completa está en el Quickstart.
Volumen, velocidad y límites
Ver Límites de velocidad y Agrupación.
Qué esperar operativamente
- Cada solicitud es independiente. Un documento que falla nunca afecta a otro, y volver a enviar un documento fallido es siempre seguro.
- Los errores son explícitos. Una solicitud rechazada te dice por qué. Ver Errores .
- Las solicitudes fallidas no se facturan. Tampoco están las tareas de fondo fallidas ni las invitaciones de selección fallidas.
- El uso es visible por clave. Emitir claves separadas para entornos o equipos diferentes.
- Sabe lo que se almacena. Las llamadas de análisis, evaluación, traducción, detección de idioma, resumen y transcripción sincrónicas no registran más que breves fragmentos cuando una llamada AI falla. Los trabajos registrados, el asistente de currículum, las tareas en segundo plano y las entrevistas de selección conservan los datos. Ver Manejo de datos.
Facturación
Prepagado y bajo petición, sin suscripción: $0.01 por la mayoría de las operaciones (por CV o documento para listas), $0.001 para la detección de idiomas, aproximadamente $0.002 por minuto de audio para grabaciones, y $0.02 por cada invitación a pantalla enviada. Tabla completa en Precios y facturación.
Curriculo dentro de tu asistente AI
Además del API, los equipos de Curriculo ATS pueden gestionar su proceso 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. Consulta la documentación de y MCP.
FAQ
¿Mi usuario de ATS necesita un inicio de sesión de Curriculo?
No. Tu producto llama al Curriculo API con una clave de la Consola de Desarrolladores. Tus usuarios nunca inician sesión en Curriculo.
¿Se almacenan los datos de los candidatos?
No por las operaciones síncronas, aparte de breves fragmentos registrados cuando falla una llamada a AI. Las tareas en segundo plano, los trabajos registrados, los currículums guardados y las entrevistas de selección conservan datos; consulte la sección sobre manejo de datos.
¿Puedo enviar currículums en cualquier idioma?
Sí. Los valores analizados permanecen en el propio idioma y sistema de escritura del CV, y la traducción abarca 202 idiomas.
Actualizado