enrich-batch
Enriquece hasta 15 candidatos de LinkedIn en una sola llamada.
/talent-scout/enrich/batchEnriquece 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
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| talents | { urn, linkedinUrl? }[] | Sí | De 1 a 15 candidatos. linkedinUrl es opcional si el candidato ya está en caché |
| forceRefresh | boolean | Opcional | Vuelve 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" }
]
}'{
"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:
{
"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
| code | Cuándo |
|---|---|
INSUFFICIENT_CREDITS | No hay crédito suficiente para los candidatos que hacía falta enriquecer. Devuelve requiredCredits / availableCredits, y no se despacha nada |