Para desarrolladores · Beta

Matching de IA en tu sistema

Envía hojas de vida y vacantes. Recibe scores de compatibilidad en segundos. Integra la IA de IAmpleo en tu ATS, ERP o sistema interno con unos pocos endpoints REST.

Ver inicio rápido Solicitar acceso →

0–100

Score de match

~3s

Tiempo de respuesta

REST

API estándar

match.sh

curl -X POST https://iampleo.com/api/v1/match \
  -H "Authorization: Bearer sk_test_TuApiKey" \
  -H "Content-Type: application/json" \
  -d '{
    "candidato": {
      "nombre": "Carlos Pérez",
      "habilidades": ["Python", "Machine Learning", "SQL"],
      "experiencia": [{
        "cargo": "Data Scientist",
        "empresa": "Bancolombia",
        "duracion": "3 años"
      }]
    },
    "vacante": {
      "titulo": "Data Scientist Senior",
      "descripcion": "Buscamos experto en ML para equipo de analítica.",
      "habilidadesRequeridas": ["Python", "TensorFlow", "SQL"],
      "experienciaMinima": 3
    }
  }'

Respuesta

{
  "score": 87,
  "nivel": "alto",
  "breakdown": { ... },
  "fortalezas": [ ... ],
  "recomendacion": "Avanzar a entrevista."
}

⚡

Score en segundos

Recibe un score 0–100 con desglose por habilidades, experiencia, educación e idiomas. Alimentado por Claude Opus 4.8.

📄

Análisis de CV con IA

Extrae nombre, email, habilidades, experiencia y educación. Puntaje de calidad del CV incluido.

🔔

Webhooks en tiempo real

Recibe notificaciones POST en tu endpoint cuando un match o análisis de CV esté listo.

🧪

Sandbox de pruebas

Usa tu clave sk_test_ para obtener respuestas mock realistas sin consumir créditos.

Autenticación

Todas las peticiones requieren una API key en el header Authorization.

Header requerido

Authorization: Bearer sk_test_xxxxxxxxxxxxxxxx

sk_test_ — Sandbox

Respuestas mock realistas. Sin consumo de créditos. Úsala para desarrollar e integrar.

sk_live_ — Producción

Llama a Claude Opus 4.8 en tiempo real. Requiere plan activo y consume créditos.

Inicio rápido

Solicita tu API key

Completa el formulario de acceso anticipado. Recibirás tus claves sandbox y producción en 1–2 días hábiles.

Solicitar acceso →

Prueba el endpoint de match

curl -X POST https://iampleo.com/api/v1/match \
  -H "Authorization: Bearer sk_test_TuApiKey" \
  -H "Content-Type: application/json" \
  -d '{
    "candidato": {
      "nombre": "Carlos Pérez",
      "habilidades": ["Python", "Machine Learning", "SQL"],
      "experiencia": [{
        "cargo": "Data Scientist",
        "empresa": "Bancolombia",
        "duracion": "3 años"
      }]
    },
    "vacante": {
      "titulo": "Data Scientist Senior",
      "descripcion": "Buscamos experto en ML para equipo de analítica.",
      "habilidadesRequeridas": ["Python", "TensorFlow", "SQL"],
      "experienciaMinima": 3
    }
  }'

Analiza un CV

curl -X POST https://iampleo.com/api/v1/cv/analizar \
  -H "Authorization: Bearer sk_test_TuApiKey" \
  -H "Content-Type: application/json" \
  -d '{
    "cvTexto": "Carlos Pérez — Data Scientist\n5 años de experiencia...",
    "idioma": "es"
  }'

Registra un webhook

curl -X POST https://iampleo.com/api/v1/webhooks \
  -H "Authorization: Bearer sk_live_TuApiKey" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://tu-sistema.com/webhooks/iampleo",
    "eventos": ["match.completo", "cv.analizado"],
    "descripcion": "Webhook ATS principal"
  }'

Referencia de endpoints

Base URL: https://iampleo.com

Método	Endpoint	Descripción	Body requerido	Retorna
POST	`/api/v1/match`	Score de compatibilidad candidato ↔ vacante	candidato, vacante	score, nivel, breakdown, fortalezas, brechas, recomendacion
POST	`/api/v1/cv/analizar`	Extracción y análisis de hoja de vida	cvTexto	nombre, email, habilidades, experiencia, educacion, puntajeCV
GET	`/api/v1/webhooks`	Lista los webhooks registrados	—	webhooks[]
POST	`/api/v1/webhooks`	Registra un nuevo webhook	url, eventos	ok, id
DELETE	`/api/v1/webhooks?id=<id>`	Elimina un webhook por ID	id (query param)	ok
GET	`/api/v1/health`	Estado del servicio y versión	—	status, version, timestamp

Webhooks en tiempo real

Registra una URL y IAmpleo enviará un POST automáticamente cada vez que un proceso complete.

match.completo

Se dispara cuando POST /api/v1/match termina de calcular el score.

cv.analizado

Se dispara cuando POST /api/v1/cv/analizar termina la extracción.

Payload del evento

{
  "event": "match.completo",
  "data": { "score": 87, "nivel": "alto", ... },
  "timestamp": "2026-07-29T15:00:00.000Z"
}

Header incluido: X-IAmpleo-Event: match.completo

Respuesta completa — Match

El endpoint /api/v1/match retorna un score detallado con desglose por dimensión, fortalezas, brechas y recomendación generada por IA.

scorenumberCompatibilidad 0–100

nivel"alto" | "medio" | "bajo"alto ≥75, medio ≥50

breakdownobjectScore por habilidades, experiencia, educacion, idiomas, cultural

fortalezasstring[]Puntos a favor del candidato

brechasstring[]Gaps detectados

recomendacionstringPárrafo con veredicto y próximos pasos

Ejemplo de respuesta completa

{
  "score": 87,
  "nivel": "alto",
  "breakdown": {
    "habilidades": 92,
    "experiencia": 88,
    "educacion": 85,
    "idiomas": 75,
    "cultural": 90
  },
  "fortalezas": [
    "Experiencia directa como Data Scientist",
    "Stack técnico alineado al 92%"
  ],
  "brechas": ["No menciona TensorFlow explícitamente"],
  "recomendacion": "Candidato altamente compatible. Avanzar a entrevista."
}

🧪

Sandbox incluido

Usa cualquier clave con prefijo sk_test_ para recibir respuestas mock realistas sin consumir créditos de IA. Las respuestas sandbox tienen el campo "sandbox": true.

Authorization: Bearer sk_test_xxxxxxxxxxxxxxxx

Listo para integrarlo en tu sistema

Solicita acceso anticipado hoy. El equipo de IAmpleo te enviará tus credenciales y una demo personalizada.

Solicitar API key →

¿Preguntas? api@iampleo.com