Reclee

enrich-batch

Enriquece hasta 15 candidatos de LinkedIn en una sola llamada.

POST/talent-scout/enrich/batch

Enriquece hasta 15 candidatos en una sola llamada, en vez de llamar a enrich una vez por candidato. Es asíncrono: devuelve un jobId al toque, y consultás batch-status hasta que termine. Los candidatos ya enriquecidos en los últimos 30 días se saltean y no se cobran — a menos que mandes forceRefresh, en cuyo caso se vuelven a enriquecer y se cobran de nuevo.

Body

CampoTipoRequeridoDescripción
talents{ urn, linkedinUrl? }[]De 1 a 15 candidatos. linkedinUrl es opcional si el candidato ya está en caché
forceRefreshbooleanOpcionalVuelve a enriquecer aunque exista un perfil en caché reciente (<30 días)
curl -X POST "https://api.reclee.com/v1/talent-scout/enrich/batch" \
  -H "Authorization: Bearer rk_live_TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "talents": [
      { "urn": "linkedin-a1b2c3d4", "linkedinUrl": "https://linkedin.com/in/marinaestevez" },
      { "urn": "linkedin-e5f6g7h8", "linkedinUrl": "https://linkedin.com/in/juanperez" }
    ]
  }'
Respuesta — despachado
{
  "success": true,
  "queued": true,
  "jobId": "batch-collect-9d666702-47c2-431d-b510-f42006453d35",
  "status": "QUEUED",
  "skippedCount": 0,
  "processCount": 2,
  "totalCreditsDeducted": 0.02,
  "companyCredits": 1199.37,
  "companyExtraCredits": 300,
  "cachedProfiles": {}
}

Si todos los candidatos que mandaste ya estaban enriquecidos recientemente, no se despacha nada — te devuelve los perfiles completos al toque en vez de un jobId:

Respuesta — todo ya estaba en caché
{
  "success": true,
  "queued": false,
  "jobId": null,
  "skippedCount": 2,
  "processCount": 0,
  "totalCreditsDeducted": 0,
  "companyCredits": 1199.37,
  "companyExtraCredits": 300,
  "cachedProfiles": {
    "linkedin-a1b2c3d4": { "data": { "full_name": "Marina Estévez", "...": "perfil completo" } }
  }
}

Consultá batch-status con el jobId cada 15-30 segundos hasta que done: true — esa respuesta incluye el perfil completo de cada candidato, indexado por urn, dentro de results.

Si falla

codeCuándo
INSUFFICIENT_CREDITSNo hay crédito suficiente para los candidatos que hacía falta enriquecer. Devuelve requiredCredits / availableCredits, y no se despacha nada

En esta página