Revelar contactos
Estima el costo, revela el email o el teléfono de una persona o de un lote, sigue el resultado y respeta las marcas de No contactar.
Revelar un contacto busca el email laboral, el email personal o el teléfono de una persona de tu pool en un proveedor externo de datos. Esta guía estima el costo, revela uno y un lote, sigue el lote hasta que termina y lee los valores encontrados.
Revelar consume créditos
Cada dato encontrado consume créditos del workspace, según tu plan y el tipo de dato (un teléfono cuesta más que un email). Un dato que no se encuentra no se cobra. Estima siempre antes de revelar un lote. Ver Créditos y uso.
export RECLEE_API="https://app.reclee.com/api/v1"
export RECLEE_API_KEY="rcl_..."Los tipos de dato son EMAIL_WORK, EMAIL_PERSONAL y PHONE.
Estima cuánto cuesta
POST /talent/contacts/reveal/estimate no gasta nada. Recibe profileIds (hasta 50) o un longlistId, y los types que quieres:
curl -s -X POST "$RECLEE_API/talent/contacts/reveal/estimate" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"profileIds": ["6a8c0e2f-7b9d-4e1f-8a3c-5d7e9f1a3b52", "7b9d1f3a-8c0e-4f2a-9b4d-6e8f0a2b4c63"],
"types": ["EMAIL_WORK", "PHONE"]
}'{
"profiles": 2,
"requested": 4,
"toBuy": 3,
"alreadyHave": 1,
"alreadySearched": 0,
"inFlight": 0,
"withoutLinkedin": 0,
"doNotContact": 0,
"workspaceCredits": 110,
"fitsInBalance": true,
"balanceUnchecked": false,
"fitsCredit": true,
"exceedsCap": false
}toBuy: cuántos datos se van a buscar de verdad. Lo que ya tienes (alreadyHave), lo que se buscó sin éxito hace poco (alreadySearched), lo que ya está en curso (inFlight) y las personas sin LinkedIn (withoutLinkedin) no se buscan ni se cobran.doNotContactcuenta a las personas marcadas «No contactar», que quedan afuera enteras.workspaceCredits: lo máximo que se cobra a tu workspace si se encuentra todo.fitsCredit: falseanticipa un402 NO_CREDITS;exceedsCap: true, un413 TOO_LARGE.
Revela el contacto de una persona
Con un solo profileId, enrich_contact busca dentro de la misma llamada. Los emails suelen resolverse en el momento; el teléfono suele tardar más.
curl -s -X POST "$RECLEE_API/actions/enrich_contact" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 3b5d7f9a-4c6e-4a8b-9d0f-2e4a6c8e0b1c" \
-d '{
"profileIds": ["6a8c0e2f-7b9d-4e1f-8a3c-5d7e9f1a3b52"],
"types": ["EMAIL_WORK", "PHONE"]
}'{
"data": {
"people": 1,
"contacts": [
{ "type": "EMAIL_WORK", "status": "found" },
{ "type": "PHONE", "status": "searching" }
]
},
"links": [ { "kind": "profile", "id": "6a8c0e2f-7b9d-4e1f-8a3c-5d7e9f1a3b52", "label": "Martina Ocampo", "href": "https://app.reclee.com/..." } ],
"next": { "missing": [], "suggestions": [ { "tool": "get_profile", "input": { "profileId": "6a8c0e2f-7b9d-4e1f-8a3c-5d7e9f1a3b52" } } ] },
"cost": { "aiUsagePct": 0, "teamUsagePct": 0, "credits": 10, "billedLater": true }
}Cada status es found, searching, notFound o failed. La acción nunca devuelve el valor: el email o el teléfono se leen en el paso 5. cost.credits es lo que se cobró hasta ahora; billedLater: true indica que queda algo en búsqueda y se cobrará si aparece.
La alternativa REST es POST /talent/contacts/reveal con { "profileId", "types" }. Responde un array con el estado de cada dato, valor incluido cuando ya se encontró, y se puede volver a llamar para consultar: si no queda nada por comprar, devuelve el estado actual sin cobrar.
[
{ "type": "EMAIL_WORK", "status": "FOUND", "value": "martina.ocampo@kuanta.io", "resolvedAt": "2026-10-22T16:00:04.000Z" },
{ "type": "PHONE", "status": "DISPATCHED", "value": null, "resolvedAt": null }
]Revela un lote
Para varias personas, POST /talent/contacts/reveal/batch crea un lote y responde enseguida, sin esperar los datos. Recibe lo mismo que la estimación (profileIds hasta 50, o un longlistId para revelar toda una longlist).
curl -s -X POST "$RECLEE_API/talent/contacts/reveal/batch" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 4c6e8a0b-5d7f-4b9c-8e1a-3f5b7d9f1c2d" \
-d '{
"longlistId": "7e9a1c3d-8f0b-4c2d-9e4a-6b8c0d2e4f5c",
"types": ["EMAIL_WORK"]
}'{ "batchId": "5d7f9b1c-6e8a-4c0d-9f2b-4a6c8e0a2d3e", "total": 43, "credits": 53.75, "skipped": [] }Guarda batchId. total es cuántos datos se van a buscar. skipped lista a quienes el lote dejó afuera por estar marcados «No contactar» ({ profileId, reason: "DO_NOT_CONTACT" }). Para saber cuánto se cobra a tu workspace, usa workspaceCredits de la estimación y GET /billing/usage-standing después.
enrich_contact con dos o más profileIds también revela en lote, pero no devuelve un batchId: responde { people, lookups, searching: true } (más skipped si dejó a alguien afuera) y el seguimiento se hace por persona (paso 5).
Sigue el lote
GET /talent/contacts/batches/{batchId} devuelve contadores. El lote terminó cuando pending llega a 0.
curl -s "$RECLEE_API/talent/contacts/batches/5d7f9b1c-6e8a-4c0d-9f2b-4a6c8e0a2d3e" \
-H "Authorization: Bearer $RECLEE_API_KEY"{
"id": "5d7f9b1c-6e8a-4c0d-9f2b-4a6c8e0a2d3e",
"total": 43,
"pending": 5,
"found": 36,
"notFound": 2,
"failed": 0,
"types": ["EMAIL_WORK"],
"estimatedCredits": 53.75,
"createdAt": "2026-10-22T16:10:00.000Z"
}Lee los valores encontrados
POST /talent/contacts/states devuelve el estado y el valor de cada dato de hasta 500 personas, sin comprar nada:
curl -s -X POST "$RECLEE_API/talent/contacts/states" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "profileIds": ["6a8c0e2f-7b9d-4e1f-8a3c-5d7e9f1a3b52"] }'{
"6a8c0e2f-7b9d-4e1f-8a3c-5d7e9f1a3b52": [
{ "type": "EMAIL_WORK", "status": "FOUND", "value": "martina.ocampo@kuanta.io", "resolvedAt": "2026-10-22T16:00:04.000Z" },
{ "type": "EMAIL_PERSONAL", "status": null, "value": null, "resolvedAt": null },
{ "type": "PHONE", "status": "NOT_FOUND", "value": null, "resolvedAt": "2026-10-22T16:04:51.000Z" }
]
}status es PENDING o DISPATCHED mientras se busca, FOUND, NOT_FOUND o FAILED al terminar, y null si ese dato nunca se pidió.
Si no se encuentra
NOT_FOUNDno se cobra: el crédito reservado se libera.- Un dato que no se encontró no se vuelve a buscar durante 90 días: la estimación lo cuenta en
alreadySearchedy no lo cobra. FAILEDsignifica que los intentos fallaron; tampoco se cobra.- Si todo lo que pides ya se conoce, está en curso, se buscó hace poco o la persona no tiene LinkedIn, la acción contesta
409 NOTHING_TO_REVEALsin gastar.
No contactar
Marcar a alguien como No contactar registra que no quiere que lo contacten. La marca impide sumarlo a una vacante (add_to_job_post lo cuenta en blocked), moverlo en el pipeline (409 DO_NOT_CONTACT) y revelar sus datos: la estimación lo cuenta en doNotContact y no lo cotiza, el reveal de una sola persona marcada contesta 409 DO_NOT_CONTACT y un lote la saltea y la devuelve en skipped. Nada de eso se cobra.
Para marcar, set_profile_do_not_contact con hasta 200 personas y una nota obligatoria:
curl -s -X POST "$RECLEE_API/actions/set_profile_do_not_contact" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"profileIds": ["7b9d1f3a-8c0e-4f2a-9b4d-6e8f0a2b4c63"],
"note": "Pidió por email no recibir más propuestas."
}'{ "data": { "doNotContact": true, "changed": 1, "unchanged": 0 }, "links": [ … ] }Quien ya estaba marcado conserva su fecha y su motivo originales. La marca no se levanta por la API: se levanta desde la app. La versión REST es PUT /talent/pool/{profileId}/do-not-contact con { "note" }.
Errores que vas a ver
| Código | Status | Qué significa |
|---|---|---|
NO_CREDITS | 402 | Los créditos del workspace no cubren lo que pides. Se verifica antes de gastar. |
NOTHING_TO_REVEAL | 409 | No queda nada por buscar en lo que pediste. |
DO_NOT_CONTACT | 409 | La persona (o todas las del lote) está marcada «No contactar». No se gasta nada. |
TOO_LARGE | 413 | El lote supera el máximo permitido; divídelo. |
PROVIDER_NO_CREDITS | 503 | La búsqueda de contactos no está disponible en este momento; avísale a quien administra Reclee. |
SEAT_REQUIRED | 403 | Revelar requiere un rol con asiento (OWNER o RECRUITER). |
NOT_FOUND | 404 | La persona, la longlist o el lote no existen en tu workspace. |