contact-batch

Desbloquea email de trabajo, email personal y/o teléfono para hasta 15 candidatos en una sola llamada, en vez de llamar a contact una vez por candidato. Es asíncrono, igual que contact — devuelve un jobId al toque, y después consultás batch-status.

Los candidatos tienen que estar ya enriquecidos (desde search, enrich, o enrich-batch) — un candidato que todavía no está enriquecido se saltea, no se cobra, y aparece listado en notEnrichedIds.

Cobra por adelantado cada campo pedido para cada candidato que lo necesite; lo que no llegue a resolverse se reembolsa automáticamente a medida que cada ítem termina.

Body

curl -X POST "https://api.reclee.com/v1/talent-scout/contact/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" }
    ],
    "requestedFields": ["work_email", "personal_email"]
  }'

{
  "success": true,
  "queued": true,
  "jobId": "batch-contact-287de532-f86a-4fdf-8db9-ae044b5fe5f0",
  "status": "QUEUED",
  "skippedCount": 0,
  "processCount": 2,
  "totalCreditsCharged": 0.8,
  "companyCredits": 1198.57,
  "companyExtraCredits": 300
}

Consultá batch-status con el jobId cada 15-30 segundos hasta que done: true. Su mapa results (indexado por urn) incluye workEmail/personalEmail/phoneNumber para los campos que se resolvieron en cada candidato, y totalCreditsUsed refleja solo lo que realmente se resolvió — cualquier diferencia entre lo cobrado y lo resuelto se reembolsa automáticamente.

Si falla