Reclee

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. doNotContact cuenta 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: false anticipa un 402 NO_CREDITS; exceedsCap: true, un 413 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_FOUND no 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 alreadySearched y no lo cobra.
  • FAILED significa 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_REVEAL sin 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ódigoStatusQué significa
NO_CREDITS402Los créditos del workspace no cubren lo que pides. Se verifica antes de gastar.
NOTHING_TO_REVEAL409No queda nada por buscar en lo que pediste.
DO_NOT_CONTACT409La persona (o todas las del lote) está marcada «No contactar». No se gasta nada.
TOO_LARGE413El lote supera el máximo permitido; divídelo.
PROVIDER_NO_CREDITS503La búsqueda de contactos no está disponible en este momento; avísale a quien administra Reclee.
SEAT_REQUIRED403Revelar requiere un rol con asiento (OWNER o RECRUITER).
NOT_FOUND404La persona, la longlist o el lote no existen en tu workspace.

Siguientes pasos

En esta página