Curriculo ATS REST API

Integración

Acceso programático completo a tus datos de contratación. Crea empleos, obtén puntuaciones de candidatos, sincroniza pipelines y construye flujos de trabajo personalizados. Disponible en el plan Pro ($50/mes).

La API REST de CurriculoATS proporciona acceso programático completo a tus datos de contratación, permitiendo a los equipos crear empleos, recuperar puntuaciones de candidatos, gestionar etapas de pipelines y construir integraciones personalizadas con HRIS, nómina y herramientas de informes. La API utiliza convenciones REST estándar con respuestas JSON, autenticación de clave API y eventos de webhook para actualizaciones en tiempo real. Disponible en el plan Pro por $50 al mes, sin cargos por solicitud dentro de los límites de tasa.

Capacidades de la API

CRUD para Empleos y Candidatos

Crea, lee, actualiza y elimina empleos y candidatos programáticamente. Publica nuevas ofertas de empleo desde herramientas internas, actualiza etapas de candidatos en bloque y sincroniza perfiles de candidatos con sistemas externos. Operaciones CRUD completas en todos los recursos principales.

Puntuaciones y Datos de Pipeline

Recupera Puntuaciones de Impacto (0-100) y desgloses de dimensiones para cada candidato. Consulta etapas de pipeline, rastrea la progresión de candidatos y obtén métricas de contratación agregadas para paneles de control e informes personalizados.

Eventos de Webhook

Suscríbete a eventos de webhook en tiempo real: nueva solicitud recibida, candidato puntuado, cambio de etapa, oferta enviada, candidato contratado. Cada webhook entrega una carga útil JSON con el contexto completo del evento a tu endpoint.

Exportación Masiva

Exporta datos de candidatos, resultados de puntuación y instantáneas de pipeline en bloque. Extrae todos los candidatos para un rol, todas las puntuaciones a través de roles o el historial completo de pipeline para requisitos de cumplimiento e informes.

Casos de Uso

Sincronización con HRIS y Nómina

Cuando un candidato es marcado como contratado en CurriculoATS, envía automáticamente su perfil a tu HRIS (BambooHR, Rippling, etc.) o sistema de nómina (Gusto, ADP). Elimina la entrada manual de datos entre la contratación y la integración.

Paneles de Control de Análisis Personalizados

Obtén métricas de contratación a través de la API y construye paneles de control personalizados en tu herramienta de BI favorita, Looker, Metabase o Google Sheets. Rastrear tiempo de contratación, calidad de fuente, distribuciones de puntuación y tasas de conversión de embudos.

Publicación de Empleo Automatizada

Crea ofertas de empleo en CurriculoATS programáticamente desde tus herramientas internas o CMS del sitio de carrera. Cuando tu equipo abra un nuevo rol, la API crea el empleo, establece criterios de puntuación y activa el pipeline automáticamente.

Enriquecimiento de Datos de Candidatos

Utiliza webhooks para activar flujos de trabajo de enriquecimiento cuando nuevos candidatos se postulen. Extrae datos adicionales de Clearbit, LinkedIn o tus propias bases de datos, y luego escribe perfiles enriquecidos de nuevo en CurriculoATS a través de la API.

Técnico

Autenticación y Límites de Tasa

Autenticación de Clave API

Genera una clave API desde tu tablero de CurriculoATS en Configuración > API. Incluye la clave en el encabezado de Autorización de cada solicitud. Las claves se pueden rotar en cualquier momento sin interrumpir integraciones activas.

Límites de Tasa

Los límites de tasa estándar son 100 solicitudes por minuto por clave API. La API devuelve códigos de estado 429 cuando se superan los límites, con un encabezado Retry-After que indica cuándo volver a intentar. Límites más altos están disponibles en el plan Enterprise.

Documentación

La documentación completa de la API está disponible en el portal de desarrolladores de CurriculoATS para suscriptores del plan Pro. Incluye explorador de API interactivo, ejemplos de código en cURL, Python, Node.js y Ruby, además de herramientas de prueba de webhook.

Ejemplo de Código

Crea una nueva oferta de trabajo con una sola llamada a la API.

# Crear una nueva oferta de trabajo
curl -X POST https://api.curriculo.me/v1/jobs \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Senior Backend Engineer",
"department": "Engineering",
"location": "Remote",
"employment_type": "full_time",
"description": "Construir y escalar nuestra infraestructura API...",
"scoring_criteria": {
"role_fit_weight": 40,
"outcomes_weight": 35,
"context_weight": 25
}
}'