Sourcing
Arma longlists de candidatos para una vacante por API, desde el perfil ideal hasta la lista entregada.
El sourcing arma longlists de candidatos para una vacante: describes el perfil ideal (ICP), defines las búsquedas que lo encuentran y una corrida busca, enriquece y puntúa perfiles contra los criterios de la vacante hasta llenar la lista. Estas rutas cubren todo el ciclo, desde proponer el ICP hasta exportar la longlist entregada, y te permiten puntuar con tu propio modelo.
Las corridas consumen créditos: antes de arrancar una, estima su costo con GET /sourcing/runs/quote y revisa si puede arrancar con GET /sourcing/runs/startable. Las escrituras principales también están como acciones de sourcing.
Perfil de talento (ICP)
El perfil de talento ideal (ICP) describe a quién se busca para una vacante: países, variantes de título, skills, idiomas y el antiperfil. No puntúa: sólo orienta dónde buscar. Cada vacante puede tener varios; una corrida usa el más reciente que esté activo.
Estados: ACTIVE (en uso), NEEDS_REVIEW (propuesto por la IA y esperando aprobación) y DISCARDED (cerrado con su motivo).
GET /sourcing/talent-icps
/sourcing/talent-icpsLista los ICP abiertos (ACTIVE y NEEDS_REVIEW) de una vacante, del más nuevo al más viejo.
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | uuid | Sí | La vacante. |
| page | integer | Opcional | Página, desde 1. |
| pageSize | integer | Opcional | Filas por página, hasta 200. Default 50. |
Pagina: devuelve { rows, total, page, pageSize }. Ver paginación.
curl "https://app.reclee.com/api/v1/sourcing/talent-icps?jobPostId=3f1c2a9e-7b4d-4e8a-9c21-5d6f7a8b9c01" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"rows": [
{
"id": "8d2e4f6a-1b3c-4d5e-8f70-9a1b2c3d4e5f",
"jobPostId": "3f1c2a9e-7b4d-4e8a-9c21-5d6f7a8b9c01",
"name": "Backend senior en fintech",
"country": "AR",
"city": "Buenos Aires",
"worksAt": "Fintech o banca digital",
"titleVariants": ["Backend Engineer", "Senior Software Engineer"],
"seniority": "Senior",
"minYearsExperience": 5,
"languages": ["Inglés"],
"skills": ["Go", "PostgreSQL", "Kubernetes"],
"antiProfile": "Perfiles sólo frontend o de consultoras de staffing",
"version": 3,
"description": "Ingeniero backend que ya escaló pagos en producción.",
"status": "ACTIVE",
"closeReason": null,
"createdAt": "2026-09-14T13:02:11.000Z",
"updatedAt": "2026-09-20T10:45:00.000Z"
}
],
"total": 1,
"page": 1,
"pageSize": 50
}POST /sourcing/talent-icps
/sourcing/talent-icpsCrea un ICP activo para una vacante. Devuelve el ICP creado, con la misma forma que en el listado. Acepta Idempotency-Key (ver idempotencia).
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | uuid | Sí | La vacante a la que pertenece. |
| name | string | Sí | Nombre, de 1 a 200 caracteres. |
| country | string | null | Opcional | País donde buscar. |
| city | string | null | Opcional | Ciudad donde buscar. |
| worksAt | string | null | Opcional | Dónde trabaja hoy la persona buscada (tipo de empresa o industria). |
| titleVariants | string[] | Opcional | Variantes del título del puesto. Default []. |
| seniority | string | null | Opcional | Seniority buscada. |
| minYearsExperience | integer | null | Opcional | Años mínimos de experiencia, de 0 a 60. |
| languages | string[] | Opcional | Idiomas. Default []. |
| skills | string[] | Opcional | Skills. Default []. |
| antiProfile | string | null | Opcional | A quién no se busca. |
| description | string | null | Opcional | Descripción libre del perfil. |
curl -X POST "https://app.reclee.com/api/v1/sourcing/talent-icps" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 6a0b1f7e-2c4d-4b8e-9f10-112233445566" \
-d '{
"jobPostId": "3f1c2a9e-7b4d-4e8a-9c21-5d6f7a8b9c01",
"name": "Backend senior en fintech",
"country": "AR",
"titleVariants": ["Backend Engineer", "Senior Software Engineer"],
"skills": ["Go", "PostgreSQL"],
"minYearsExperience": 5
}'Errores
FORBIDDEN(403): tu rol no puede escribir (por ejemplo,VIEWER).
Para que la IA lo escriba a partir de la vacante: write_talent_icp.
POST /sourcing/talent-icps/propose
/sourcing/talent-icps/proposeLa IA lee la vacante y devuelve un borrador de ICP. No guarda nada: revisas el borrador y lo creas con POST /sourcing/talent-icps. La respuesta llega dentro de la misma request (puede tardar hasta unos minutos). Acepta Idempotency-Key.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | uuid | Sí | La vacante a leer. |
curl -X POST "https://app.reclee.com/api/v1/sourcing/talent-icps/propose" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "jobPostId": "3f1c2a9e-7b4d-4e8a-9c21-5d6f7a8b9c01" }'Respuesta (extracto)
{
"icp": {
"name": "Backend senior en fintech",
"country": "AR",
"city": null,
"worksAt": "Fintech o banca digital",
"seniority": "Senior",
"minYearsExperience": 5,
"titleVariants": ["Backend Engineer", "Senior Software Engineer"],
"skills": ["Go", "PostgreSQL"],
"languages": ["Inglés"],
"antiProfile": null,
"description": "Ingeniero backend con experiencia en pagos."
},
"tokens": 2310,
"promptTokens": 1980,
"completionTokens": 330
}Errores
NOT_FOUND(404): la vacante no existe o no la ves.USAGE_WINDOW,USAGE_EXHAUSTED(402): el uso de IA del plan está agotado por ahora.
GET /sourcing/talent-icps/{talentIcpId}
/sourcing/talent-icps/{talentIcpId}Devuelve un ICP, en cualquier estado.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| talentIcpId | uuid | Sí | El ICP. |
curl "https://app.reclee.com/api/v1/sourcing/talent-icps/8d2e4f6a-1b3c-4d5e-8f70-9a1b2c3d4e5f" \
-H "Authorization: Bearer $RECLEE_API_KEY"La respuesta es un ICP con la forma del listado.
Errores
NOT_FOUND(404): no existe o no lo ves.
PATCH /sourcing/talent-icps/{talentIcpId}
/sourcing/talent-icps/{talentIcpId}Edita un ICP. Sólo se escriben los campos que mandas; una lista reemplaza la lista entera y null vacía un texto. Cada edición sube version. Devuelve el ICP actualizado.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| talentIcpId | uuid | Sí | El ICP. |
Body: los mismos campos que POST /sourcing/talent-icps, todos opcionales y sin jobPostId.
curl -X PATCH "https://app.reclee.com/api/v1/sourcing/talent-icps/8d2e4f6a-1b3c-4d5e-8f70-9a1b2c3d4e5f" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "skills": ["Go", "PostgreSQL", "Kafka"], "city": null }'Errores
NOT_FOUND(404): no existe o no lo ves.ICP_CLOSED(409): el ICP está cerrado; no vuelve a correr y no se edita.FORBIDDEN(403): tu rol no puede escribir.
También como acción: update_talent_icp.
DELETE /sourcing/talent-icps/{talentIcpId}
/sourcing/talent-icps/{talentIcpId}Un ICP no se borra: contesta 405 DELETE_NOT_ALLOWED con suggestions: [{ "tool": "close_talent_icp" }]. Para cerrarlo con su motivo usa POST /actions/close_talent_icp (close_talent_icp); las longlists que salieron de él siguen apuntándolo.
POST /sourcing/talent-icps/{talentIcpId}/approve
/sourcing/talent-icps/{talentIcpId}/approveAprueba un ICP propuesto (NEEDS_REVIEW) y lo pasa a ACTIVE. Devuelve el ICP.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| talentIcpId | uuid | Sí | El ICP propuesto. |
curl -X POST "https://app.reclee.com/api/v1/sourcing/talent-icps/8d2e4f6a-1b3c-4d5e-8f70-9a1b2c3d4e5f/approve" \
-H "Authorization: Bearer $RECLEE_API_KEY"Errores
NOT_FOUND(404): no existe o no está esperando revisión.
También como acción: update_talent_icp con approve: true.
POST /sourcing/talent-icps/{talentIcpId}/definitions/propose
/sourcing/talent-icps/{talentIcpId}/definitions/proposeLa IA lee el ICP y propone definiciones de búsqueda. No guarda nada: cada propuesta trae su query ya validada; las guardas con POST /sourcing/search-definitions. Las propuestas de la IA que no se pudieron convertir en una búsqueda válida se descartan y se cuentan en discarded. Acepta Idempotency-Key.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| talentIcpId | uuid | Sí | El ICP. |
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| count | integer | Opcional | Cuántas proponer. Default 10, nunca más que los lugares libres del ICP (máximo 50 definiciones por ICP). |
curl -X POST "https://app.reclee.com/api/v1/sourcing/talent-icps/8d2e4f6a-1b3c-4d5e-8f70-9a1b2c3d4e5f/definitions/propose?count=5" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"definitions": [
{
"name": "Backend Go en Argentina",
"rationale": "Título y skill principal del ICP, acotado al país.",
"query": {
"schemaVersion": 1,
"title": "Backend Engineer",
"skills": ["Go"],
"geoCountryCode": "AR"
}
}
],
"discarded": 1,
"tokens": 3120,
"promptTokens": 2600,
"completionTokens": 520
}Errores
LIMIT_REACHED(409): el ICP ya tiene 50 definiciones ocupando lugar.NOT_FOUND(404): el ICP no existe o no lo ves.USAGE_WINDOW,USAGE_EXHAUSTED(402): el uso de IA del plan está agotado por ahora.
Definiciones de búsqueda
Una definición de búsqueda es un conjunto de filtros (query) que trae perfiles para un ICP. Una corrida va rotando entre las definiciones del ICP según cuánto rinde cada una.
Estados: READY (todavía no corrió; editable), ACTIVE (ya corrió), PAUSED, EXHAUSTED (no quedan resultados) y NEEDS_REVIEW (propuesta esperando aprobación). Un ICP admite hasta 50 definiciones que ocupen lugar (las PAUSED, EXHAUSTED y NEEDS_REVIEW no cuentan).
El objeto query
Todos los campos son opcionales. schemaVersion vale 1.
| Campo | Tipo | Notas |
|---|---|---|
title, headline, summary, description | string | Mínimo 3 caracteres. |
firstName, lastName | string | Mínimo 3 caracteres. |
geoCountryCode | string | Código ISO de 2 letras. Obligatorio si mandas geoCity. |
geoCity | string | Mínimo 3 caracteres. |
skills | string[] | Hasta 20. skillsMatch: any o all. |
skillCountMin, skillCountMax | integer | |
speaksLanguage | string[] | Hasta 20. |
primaryLanguage | string | |
organizationSlugs, excludeOrganizationSlugs | string[] | Hasta 20. |
currentOnly | boolean | Sólo el empleo actual. |
companySizeMin, companySizeMax | integer | Desde 1. |
industry, excludeIndustries, excludeTitles | string[] | Hasta 20, mínimo 3 caracteres cada uno. |
jobFunction + jobFunctionMinYears | string[] + integer | Van juntos o ninguno. Años de 1 a 60. |
lastChangeWithinDays | integer | 1 a 3650. lastChangeType: joined, left o title_change. |
tenureMinYears, tenureMaxYears | integer | 0 a 60. |
companyCountMin, companyCountMax | integer | 1 a 100. |
currentCompanyCountMin | integer | 1 a 50. |
experienceMinYears | integer | 1 a 60. |
isBoomerang, isCreator, isPremium | boolean | |
followerCountMin | integer | |
educationLevel | string | phd, master, bachelor o associate. |
degree, fieldOfStudy, certificationAuthority | string | |
institutionIds, certifications | string[] | Hasta 20. |
GET /sourcing/search-definitions
/sourcing/search-definitionsLista las definiciones de un ICP, de la más vieja a la más nueva.
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| talentIcpId | uuid | Sí | El ICP. |
| page | integer | Opcional | Página, desde 1. |
| pageSize | integer | Opcional | Filas por página, hasta 200. Default 50. |
Pagina: devuelve { rows, total, page, pageSize }. Ver paginación.
curl "https://app.reclee.com/api/v1/sourcing/search-definitions?talentIcpId=8d2e4f6a-1b3c-4d5e-8f70-9a1b2c3d4e5f" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"rows": [
{
"id": "b7c8d9e0-1f2a-4b3c-8d4e-5f6a7b8c9d0e",
"talentIcpId": "8d2e4f6a-1b3c-4d5e-8f70-9a1b2c3d4e5f",
"name": "Backend Go en Argentina",
"query": {
"schemaVersion": 1,
"title": "Backend Engineer",
"skills": ["Go"],
"geoCountryCode": "AR"
},
"status": "ACTIVE",
"replacesId": null,
"createdAt": "2026-09-14T13:10:00.000Z",
"updatedAt": null
}
],
"total": 1,
"page": 1,
"pageSize": 50
}query es null si la definición se guardó con un formato que ya no es válido. replacesId sólo aparece en una propuesta que reemplaza a otra definición: aprobarla pausa la reemplazada.
POST /sourcing/search-definitions
/sourcing/search-definitionsCrea una definición en estado READY. Devuelve la definición creada. Acepta Idempotency-Key.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| talentIcpId | uuid | Sí | El ICP. |
| name | string | null | Opcional | Nombre, de 1 a 200 caracteres. |
| query | object | Sí | Los filtros (ver El objeto query). Una ciudad necesita su geoCountryCode. |
curl -X POST "https://app.reclee.com/api/v1/sourcing/search-definitions" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"talentIcpId": "8d2e4f6a-1b3c-4d5e-8f70-9a1b2c3d4e5f",
"name": "Backend Go en Córdoba",
"query": { "title": "Backend Engineer", "skills": ["Go"], "geoCity": "Córdoba", "geoCountryCode": "AR" }
}'Errores
LIMIT_REACHED(409): el ICP ya tiene 50 definiciones ocupando lugar.INVALID(400):queryno pasa la validación (por ejemplo,geoCitysingeoCountryCode).ICP_CLOSED(409): el ICP está cerrado; una búsqueda nueva nunca correría.
También como acción: create_sourcing_search.
PATCH /sourcing/search-definitions/{definitionId}
/sourcing/search-definitions/{definitionId}Edita el nombre o la query de una definición. Sólo se puede mientras está READY: una que ya corrió no cambia, para que las búsquedas viejas sigan diciendo qué se ejecutó. Devuelve la definición.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| definitionId | uuid | Sí | La definición. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| name | string | null | Opcional | Nombre, de 1 a 200 caracteres. |
| query | object | Opcional | Reemplaza la query entera. |
curl -X PATCH "https://app.reclee.com/api/v1/sourcing/search-definitions/b7c8d9e0-1f2a-4b3c-8d4e-5f6a7b8c9d0e" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "name": "Backend Go, Argentina, remoto" }'Errores
NOT_FOUND(404): no existe, no la ves, o ya no estáREADY.
DELETE /sourcing/search-definitions/{definitionId}
/sourcing/search-definitions/{definitionId}Borra una definición. Contesta 204 sin cuerpo.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| definitionId | uuid | Sí | La definición. |
curl -X DELETE "https://app.reclee.com/api/v1/sourcing/search-definitions/b7c8d9e0-1f2a-4b3c-8d4e-5f6a7b8c9d0e" \
-H "Authorization: Bearer $RECLEE_API_KEY"Errores
HAS_HISTORY(409): ya alimentó una longlist cerrada; se conserva porque la longlist dice de dónde salió cada perfil.
POST /sourcing/search-definitions/{definitionId}/approve
/sourcing/search-definitions/{definitionId}/approveAprueba una definición propuesta (NEEDS_REVIEW) para que las corridas la usen. Si reemplaza a otra (replacesId), la reemplazada se pausa en la misma operación. Devuelve la definición.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| definitionId | uuid | Sí | La definición propuesta. |
curl -X POST "https://app.reclee.com/api/v1/sourcing/search-definitions/b7c8d9e0-1f2a-4b3c-8d4e-5f6a7b8c9d0e/approve" \
-H "Authorization: Bearer $RECLEE_API_KEY"Errores
LIMIT_REACHED(409): el ICP no tiene lugar libre.NOT_FOUND(404): no existe o no está esperando revisión.
GET /sourcing/search-definitions/{definitionId}/searches
/sourcing/search-definitions/{definitionId}/searchesLas páginas de resultados que ejecutó esta definición, de la más nueva a la más vieja. Sirve para ver cuánto rindió una definición en particular.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| definitionId | uuid | Sí | La definición. |
Pagina: devuelve { rows, total, page, pageSize }. Ver paginación.
curl "https://app.reclee.com/api/v1/sourcing/search-definitions/b7c8d9e0-1f2a-4b3c-8d4e-5f6a7b8c9d0e/searches" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"rows": [
{
"id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
"searchDefinitionId": "b7c8d9e0-1f2a-4b3c-8d4e-5f6a7b8c9d0e",
"talentSearchId": null,
"longlistId": "e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b",
"status": "COMPLETED",
"cursorUsed": null,
"nextCursor": "eyJwYWdlIjoyfQ",
"totalResults": 1240,
"executedAt": "2026-09-21T15:04:00.000Z",
"error": null
}
],
"total": 1,
"page": 1,
"pageSize": 50
}status es PENDING, RUNNING, COMPLETED o FAILED.
GET /sourcing/search-definitions/performance
/sourcing/search-definitions/performanceCómo rindió cada definición de un ICP en su última página. performancePct (0 a 100) es la proporción de perfiles de esa página que calificaron; null significa que nunca corrió, que no es lo mismo que cero.
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| talentIcpId | uuid | Sí | El ICP. |
| page | integer | Opcional | Página, desde 1. |
| pageSize | integer | Opcional | Filas por página, hasta 200. Default 50. |
Pagina: devuelve { rows, total, page, pageSize }. Ver paginación.
curl "https://app.reclee.com/api/v1/sourcing/search-definitions/performance?talentIcpId=8d2e4f6a-1b3c-4d5e-8f70-9a1b2c3d4e5f" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"rows": [
{
"searchDefinitionId": "b7c8d9e0-1f2a-4b3c-8d4e-5f6a7b8c9d0e",
"performancePct": 35,
"status": "ACTIVE",
"exhausted": false,
"lastExecutedAt": "2026-09-21T15:04:00.000Z"
}
],
"total": 1,
"page": 1,
"pageSize": 50
}GET /sourcing/search-definitions/with-performance
/sourcing/search-definitions/with-performanceLas definiciones de un ICP y su rendimiento en una sola lectura, sin paginar.
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| talentIcpId | uuid | Sí | El ICP. |
curl "https://app.reclee.com/api/v1/sourcing/search-definitions/with-performance?talentIcpId=8d2e4f6a-1b3c-4d5e-8f70-9a1b2c3d4e5f" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta: { "definitions": [...], "performance": [...] }, con las formas de GET /sourcing/search-definitions y GET /sourcing/search-definitions/performance.
Corridas de sourcing
Una corrida busca perfiles con las definiciones del ICP, los enriquece, los puntúa contra los criterios de la vacante y arma una longlist con los que califican. Avanza de a una página por vez: cada página tarda alrededor de dos minutos, y llenar una longlist lleva decenas de páginas. Mientras la corrida está abierta, su longlist está OPEN; al cerrarse queda congelada.
El longlistId identifica a la corrida en todas las rutas de abajo.
Consume créditos
Cada página de una corrida busca, enriquece y puntúa perfiles: consume el uso de IA del plan y, cuando se agota, crédito comprado. Antes de arrancar, consulta GET /sourcing/runs/quote para saber qué parte del mes puede gastar una corrida con un tope de perfiles, y GET /sourcing/runs/startable para saber si la próxima corrida de una vacante puede arrancar. profileCap (default 500, máximo 2000) es el presupuesto de la corrida: al llegar ahí se pausa y espera una decisión.
Estados de una corrida (status): RUNNING (puede dar otro paso), PAUSED (se detuvo por un criterio que necesita una decisión: seguir o cerrar; ver pausedReason) y DONE (la longlist está cerrada; ver stopReason). Motivos: COMPLETE (llegó al objetivo), PROFILE_CAP (llegó al tope de perfiles), LOW_PERFORMANCE, DROUGHT (las búsquedas dejaron de traer gente que califica) y CANCELLED (la detuvo una persona).
Seguir el progreso. Una corrida es asíncrona. Consulta su estado con GET /sourcing/runs (el campo stepping dice si se está trayendo una página en este momento), lo que trae la página en curso con GET /sourcing/runs/{longlistId}/page y el historial de páginas con GET /sourcing/runs/{longlistId}/pages. Un intervalo de 10 a 30 segundos alcanza.
GET /sourcing/runs/quote
/sourcing/runs/quoteEstima cuánto puede gastar una corrida con un tope de perfiles dado, como proporción del uso de IA del mes. No abre nada.
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| profileCap | integer | Sí | Tope de perfiles a evaluar, de 1 a 2000. |
curl "https://app.reclee.com/api/v1/sourcing/runs/quote?profileCap=500" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"metered": true,
"monthShare": 0.42,
"leftShare": 0.65,
"exceedsLeft": false,
"creditCovers": true
}monthShare: lo máximo que puede gastar la corrida, contra el mes entero (0 a 1, más de 1 si cuesta más que un mes).leftShare: lo que queda del mes, contra el mes entero.exceedsLeft: puede gastar más de lo que queda; el resto se paga con crédito comprado.creditCovers: lo que queda más el crédito comprado alcanza. Si no, la corrida se pausa al agotarse.- Si el workspace no mide uso (
metered: false), las proporciones vienen ennull.
GET /sourcing/runs/startable
/sourcing/runs/startableDice si la próxima corrida de una vacante puede arrancar, y con qué ICP y qué definiciones. No abre nada: es la misma verificación que hace POST /sourcing/runs/start.
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | uuid | Sí | La vacante. |
curl "https://app.reclee.com/api/v1/sourcing/runs/startable?jobPostId=3f1c2a9e-7b4d-4e8a-9c21-5d6f7a8b9c01" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{
"talentIcpId": "8d2e4f6a-1b3c-4d5e-8f70-9a1b2c3d4e5f",
"icpName": "Backend senior en fintech",
"definitions": [
{ "id": "b7c8d9e0-1f2a-4b3c-8d4e-5f6a7b8c9d0e", "name": "Backend Go en Argentina" }
]
}Errores
SEAT_REQUIRED(403): hace falta un asiento (rolOWNERoRECRUITER).USAGE_WINDOW,USAGE_EXHAUSTED(402): el uso de IA está agotado por ahora.JOB_POST_DRAFT(409): la vacante es un borrador.NO_CRITERIA(409): la vacante no tiene criterios de sourcing.NO_ICP(409): no tiene ICP.ICP_NEEDS_REVIEW(409): el ICP espera aprobación.NO_DEFINITIONS(409): no hay definiciones activas.RUN_IN_PROGRESS(409): ya hay una corrida abierta.NOTHING_CHANGED(409): ni el ICP, ni los criterios, ni las definiciones cambiaron desde la última corrida.
POST /sourcing/runs/start
/sourcing/runs/startAbre la próxima corrida de una vacante, después de pasar la misma verificación que GET /sourcing/runs/startable, y la deja avanzando sola en segundo plano, una página por vez. Llamarla es la decisión de gastar. Acepta Idempotency-Key.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | uuid | Sí | La vacante. |
| targetSize | integer | Opcional | Cuántos perfiles calificados buscar. Default 150. No puede superar profileCap. |
| profileCap | integer | Opcional | Tope de perfiles a evaluar, de 1 a 2000. Default 500. |
curl -X POST "https://app.reclee.com/api/v1/sourcing/runs/start" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 0f9e8d7c-6b5a-4c3d-9e2f-1a0b9c8d7e6f" \
-d '{ "jobPostId": "3f1c2a9e-7b4d-4e8a-9c21-5d6f7a8b9c01", "targetSize": 50, "profileCap": 300 }'Respuesta (extracto): lo que devuelve GET /sourcing/runs/startable más run, el estado de la corrida abierta (ver GET /sourcing/runs).
{
"talentIcpId": "8d2e4f6a-1b3c-4d5e-8f70-9a1b2c3d4e5f",
"icpName": "Backend senior en fintech",
"definitions": [{ "id": "b7c8d9e0-1f2a-4b3c-8d4e-5f6a7b8c9d0e", "name": "Backend Go en Argentina" }],
"run": {
"longlistId": "e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b",
"status": "RUNNING",
"targetSize": 50,
"profileCap": 300,
"pagesRun": 0,
"profilesEvaluated": 0,
"qualified": 0,
"stepping": false
}
}Errores: los mismos que GET /sourcing/runs/startable.
También como acción: run_sourcing.
GET /sourcing/runs
/sourcing/runsEl estado de la corrida abierta de un ICP, o null si no hay ninguna. Es la forma de retomar una corrida.
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| talentIcpId | uuid | Sí | El ICP. |
curl "https://app.reclee.com/api/v1/sourcing/runs?talentIcpId=8d2e4f6a-1b3c-4d5e-8f70-9a1b2c3d4e5f" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"longlistId": "e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b",
"status": "PAUSED",
"stopReason": null,
"pausedReason": "LOW_PERFORMANCE",
"targetSize": 50,
"profileCap": 300,
"pagesRun": 6,
"profilesEvaluated": 120,
"qualified": 18,
"staleScores": 0,
"evaluators": [{ "profiles": 120 }],
"definitions": [
{
"searchDefinitionId": "b7c8d9e0-1f2a-4b3c-8d4e-5f6a7b8c9d0e",
"name": "Backend Go en Argentina",
"pages": 4,
"performancePct": 15,
"exhausted": false,
"queryFields": ["title", "skills", "geoCountryCode"],
"joinedLater": false
}
],
"activeSearchDefinitionId": "b7c8d9e0-1f2a-4b3c-8d4e-5f6a7b8c9d0e",
"startedAt": "2026-09-21T14:50:00.000Z",
"setup": {
"frozenAt": "2026-09-21T14:50:00.000Z",
"thresholdPct": 70,
"icp": { "id": "8d2e4f6a-1b3c-4d5e-8f70-9a1b2c3d4e5f", "name": "Backend senior en fintech", "version": 3 },
"criteria": [
{ "id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d", "title": "5+ años en backend", "description": null, "position": 1, "weightPct": 40, "required": true }
]
},
"stepping": false,
"autoStep": false,
"lastPage": null
}evaluators: a cuántas personas puntuó cada evaluador, sin nombrarlo. Más de una entrada significa que la lista mezcla evaluadores (por ejemplo, Reclee y los puntajes que mandaste conPOST /sourcing/scores).autoStep: si la corrida toma su próxima página sola. Se apaga cuando la corrida se pausa o cuando alguien la detiene.staleScores: puntajes tomados con criterios que después cambiaron; no cuentan hasta repuntuar.setup: el ICP y los criterios con que se abrió la corrida (quedan congelados).lastPage: sólo viene en la respuesta de un paso (POST .../step); describe la página que se acaba de traer.
POST /sourcing/runs
/sourcing/runsAbre una corrida para un ICP, o devuelve la que ya está abierta. No busca nada: abrir no es gastar. Después la avanzas con POST /sourcing/runs/{longlistId}/step, o pasas autoStep: true para que avance sola en segundo plano. Devuelve el estado de la corrida (forma de GET /sourcing/runs). Acepta Idempotency-Key.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| talentIcpId | uuid | Sí | El ICP. |
| targetSize | integer | Opcional | Perfiles calificados a buscar, de 1 a 500. Default 150. |
| profileCap | integer | Opcional | Tope de perfiles a evaluar, de 1 a 2000. Default 500. Una corrida ya abierta conserva el suyo. |
| name | string | null | Opcional | Nombre de la longlist, de 1 a 200 caracteres. |
| autoStep | boolean | Opcional | Si avanza sola en segundo plano. Default false. Se apaga sola cuando la corrida se pausa. |
curl -X POST "https://app.reclee.com/api/v1/sourcing/runs" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "talentIcpId": "8d2e4f6a-1b3c-4d5e-8f70-9a1b2c3d4e5f", "targetSize": 50, "profileCap": 300 }'Errores
SEAT_REQUIRED(403): hace falta un asiento.USAGE_WINDOW,USAGE_EXHAUSTED(402): el uso de IA está agotado por ahora.ICP_NEEDS_REVIEW(409),NO_ICP(409),NO_CRITERIA(409),NO_DEFINITIONS(409),JOB_POST_DRAFT(409): falta algo para correr.
POST /sourcing/runs/{longlistId}/step
/sourcing/runs/{longlistId}/stepAvanza la corrida una página: busca, enriquece, puntúa y mide. Devuelve el estado completo de la corrida, con lastPage describiendo la página. La respuesta llega cuando termina la página (alrededor de dos minutos): usa un timeout que lo aguante. Si otro proceso ya está trayendo una página, devuelve el estado sin gastar. Sobre una corrida cerrada no hace nada y devuelve DONE. Acepta Idempotency-Key.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| longlistId | uuid | Sí | La corrida. |
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| force | boolean | Opcional | Sobre una corrida pausada, compra exactamente una página más (seguir buscando). Default false. |
| pageSize | integer | Opcional | Perfiles por página, de 1 a 50. Default 20. |
| autoStep | boolean | Opcional | Prende o apaga el avance automático como parte de este paso. Si no lo mandas, queda como estaba. |
curl -X POST "https://app.reclee.com/api/v1/sourcing/runs/e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b/step" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
--max-time 300 \
-d '{ "force": true }'Respuesta (extracto de lastPage)
{
"lastPage": {
"searchDefinitionId": "b7c8d9e0-1f2a-4b3c-8d4e-5f6a7b8c9d0e",
"name": "Backend Go en Argentina",
"profiles": 20,
"scored": 17,
"alreadyScored": 3,
"failed": 0,
"performancePct": 25,
"rotated": false,
"durationMs": 118400,
"unrecorded": 0,
"tokens": 41200,
"promptTokens": 38000,
"completionTokens": 3200
}
}Errores
SEAT_REQUIRED(403): hace falta un asiento.USAGE_EXHAUSTED(402): no queda uso para un solo perfil; la longlist sigue abierta para cuando haya.NO_CREDITS(402): no hay crédito para cubrir la página.
También como acción: continue_sourcing.
GET /sourcing/runs/{longlistId}/page
/sourcing/runs/{longlistId}/pageLa página que la corrida está trayendo (o la última que trajo), con las personas que ya están puntuadas, de la más nueva a la más vieja. Consultala mientras hay un paso en curso. Devuelve null si todavía no corrió ninguna página.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| longlistId | uuid | Sí | La corrida. |
curl "https://app.reclee.com/api/v1/sourcing/runs/e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b/page" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"searchId": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
"searchDefinitionId": "b7c8d9e0-1f2a-4b3c-8d4e-5f6a7b8c9d0e",
"status": "RUNNING",
"profiles": 20,
"evaluations": [
{
"profileId": "4b5c6d7e-8f90-4a1b-9c2d-3e4f5a6b7c8d",
"name": "Lucía Ferreyra",
"headline": "Senior Backend Engineer en Pagofácil Labs",
"avatarUrl": null,
"scorePct": 82,
"coveragePct": 90,
"verdict": "QUALIFIED",
"criteriaMet": 4,
"criteriaTotal": 5,
"reason": "Cinco años construyendo servicios de pagos en Go.",
"evaluatedAt": "2026-09-21T15:05:12.000Z",
"fresh": true,
"counted": true
}
]
}verdict es QUALIFIED, BELOW_THRESHOLD o DISQUALIFIED. fresh: false indica que una página anterior ya tenía un puntaje vigente; counted: false, que el puntaje lo dejó una corrida anterior y esta no lo cuenta.
Errores
NOT_FOUND(404): la corrida no existe o no la ves.
GET /sourcing/runs/{longlistId}/pages
/sourcing/runs/{longlistId}/pagesTodas las páginas que trajo la corrida, de la más vieja (página 1) a la más nueva, con lo que trajo y rindió cada una.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| longlistId | uuid | Sí | La corrida. |
Pagina: devuelve { rows, total, page, pageSize }. Ver paginación.
curl "https://app.reclee.com/api/v1/sourcing/runs/e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b/pages" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"rows": [
{
"page": 1,
"searchId": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
"searchDefinitionId": "b7c8d9e0-1f2a-4b3c-8d4e-5f6a7b8c9d0e",
"searchName": "Backend Go en Argentina",
"status": "COMPLETED",
"profiles": 20,
"qualified": 5,
"performancePct": 25,
"executedAt": "2026-09-21T14:52:30.000Z",
"ownProfiles": 20
}
],
"total": 6,
"page": 1,
"pageSize": 50
}profiles, qualified y performancePct vienen en null mientras la página está en curso. ownProfiles cuenta las personas que esta página sumó a la corrida por primera vez.
Errores
NOT_FOUND(404): la corrida no existe o no la ves.
GET /sourcing/runs/{longlistId}/cancel
/sourcing/runs/{longlistId}/cancelDice si la corrida se puede detener ahora y con qué motivo se congelaría. No cierra nada: sirve para confirmar antes de llamar al POST.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| longlistId | uuid | Sí | La corrida. |
curl "https://app.reclee.com/api/v1/sourcing/runs/e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b/cancel" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta
{ "stopReason": "LOW_PERFORMANCE", "qualified": 18, "targetSize": 50 }stopReason es el motivo de la pausa si la corrida estaba pausada, o CANCELLED si no.
Errores
RUN_ALREADY_CLOSED(409): la longlist ya está cerrada.NOTHING_SCORED(409): todavía no se puntuó a nadie.RUN_STEP_IN_FLIGHT(409): se está trayendo una página; espera a que termine.
POST /sourcing/runs/{longlistId}/cancel
/sourcing/runs/{longlistId}/cancelDetiene la corrida: la longlist se congela con quienes ya calificaron y no se trae ninguna página más. Devuelve el estado final de la corrida (forma de GET /sourcing/runs, con status: "DONE").
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| longlistId | uuid | Sí | La corrida. |
curl -X POST "https://app.reclee.com/api/v1/sourcing/runs/e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b/cancel" \
-H "Authorization: Bearer $RECLEE_API_KEY"Errores: los mismos que el GET, más FORBIDDEN (403) si tu rol no puede escribir.
También como acción: cancel_sourcing. La acción no se niega en los casos de NOTHING_SCORED y RUN_STEP_IN_FLIGHT: deja de traer páginas y la corrida queda abierta hasta que la vuelvas a cancelar para congelarla.
Longlists
La longlist es el entregable de una corrida: las personas que calificaron, ordenadas. Mientras la corrida está abierta (OPEN) sus números se cuentan en vivo; al cerrarse (CLOSED_COMPLETE o CLOSED_PARTIAL) queda congelada y muestra lo mismo aunque después cambien los perfiles o los criterios.
GET /sourcing/longlists
/sourcing/longlistsLista las longlists de un ICP o de una vacante (todas las de sus ICP). Hace falta uno de los dos filtros; si mandas los dos, gana talentIcpId.
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| talentIcpId | uuid | Opcional | Las longlists de un ICP. |
| jobPostId | uuid | Opcional | Las longlists de una vacante. |
| page | integer | Opcional | Página, desde 1. |
| pageSize | integer | Opcional | Filas por página, hasta 200. Default 50. |
Pagina: devuelve { rows, total, page, pageSize }. Ver paginación.
curl "https://app.reclee.com/api/v1/sourcing/longlists?jobPostId=3f1c2a9e-7b4d-4e8a-9c21-5d6f7a8b9c01" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"rows": [
{
"id": "e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b",
"talentIcpId": "8d2e4f6a-1b3c-4d5e-8f70-9a1b2c3d4e5f",
"name": null,
"status": "CLOSED_PARTIAL",
"targetSize": 50,
"profilesEvaluated": 300,
"stopReason": "PROFILE_CAP",
"closedAt": "2026-09-22T09:30:00.000Z",
"createdAt": "2026-09-21T14:50:00.000Z",
"jobPostId": "3f1c2a9e-7b4d-4e8a-9c21-5d6f7a8b9c01",
"icpName": "Backend senior en fintech",
"icpVersion": 3,
"qualified": 41,
"avgScorePct": 78.5,
"criteriaDiffer": false,
"profileCap": 300
}
],
"total": 1,
"page": 1,
"pageSize": 50
}criteriaDiffer: true indica que la lista se congeló con criterios que después cambiaron. avgScorePct es null mientras nadie califica.
POST /sourcing/longlists
/sourcing/longlistsArma una longlist con lo que las búsquedas del ICP ya puntuaron: los QUALIFIED, de mayor a menor puntaje, cortados en targetSize. No busca ni puntúa, así que no gasta. Lo normal es dejar que una corrida se cierre, que hace esto sola; esta ruta sirve cuando corriste búsquedas por separado. Devuelve la longlist creada. Acepta Idempotency-Key.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| talentIcpId | uuid | Sí | El ICP. |
| targetSize | integer | Opcional | Tamaño máximo, de 1 a 500. Default 150. |
| name | string | null | Opcional | Nombre, de 1 a 200 caracteres. |
curl -X POST "https://app.reclee.com/api/v1/sourcing/longlists" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "talentIcpId": "8d2e4f6a-1b3c-4d5e-8f70-9a1b2c3d4e5f", "targetSize": 30, "name": "Backend fintech, primera entrega" }'Errores
NOTHING_SCORED(409): no hay nadie puntuado para elegir.
También como acción: build_longlist.
GET /sourcing/longlists/delivered
/sourcing/longlists/deliveredLas longlists entregadas (congeladas) de todo el workspace, con su vacante y cuántas personas tienen. Útil para elegir una lista y volcarla, por ejemplo, en una lista guardada.
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| page | integer | Opcional | Página, desde 1. |
| pageSize | integer | Opcional | Filas por página, hasta 200. Default 50. |
Pagina: devuelve { rows, total, page, pageSize }. Ver paginación.
curl "https://app.reclee.com/api/v1/sourcing/longlists/delivered?page=1" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"rows": [
{
"id": "e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b",
"name": "Backend senior en fintech",
"jobPostId": "3f1c2a9e-7b4d-4e8a-9c21-5d6f7a8b9c01",
"jobPostTitle": "Senior Backend Engineer",
"profileCount": 41
}
],
"total": 1,
"page": 1,
"pageSize": 50
}Una longlist sin nombre se llama como su ICP.
GET /sourcing/longlists/{longlistId}
/sourcing/longlists/{longlistId}El resumen de una longlist: su vacante, su estado y sus números, con la misma forma que una fila de GET /sourcing/longlists.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| longlistId | uuid | Sí | La longlist. |
curl "https://app.reclee.com/api/v1/sourcing/longlists/e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b" \
-H "Authorization: Bearer $RECLEE_API_KEY"Errores
NOT_FOUND(404): no existe o no la ves.
GET /sourcing/longlists/{longlistId}/entries
/sourcing/longlists/{longlistId}/entriesLas personas de la lista, tal como quedaron al congelarse (no el perfil de hoy). El trabajo vivo sobre cada candidato va por las postulaciones del ATS.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| longlistId | uuid | Sí | La longlist. |
Pagina: devuelve { rows, total, page, pageSize }. Ver paginación.
curl "https://app.reclee.com/api/v1/sourcing/longlists/e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b/entries?pageSize=100" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"rows": [
{
"rank": 1,
"profileId": "4b5c6d7e-8f90-4a1b-9c2d-3e4f5a6b7c8d",
"firstName": "Lucía",
"lastName": "Ferreyra",
"headline": "Senior Backend Engineer en Pagofácil Labs",
"linkedinUrl": "https://www.linkedin.com/in/lucia-ferreyra-ejemplo",
"scorePct": 82,
"coveragePct": 90,
"company": "Pagofácil Labs",
"city": "Córdoba",
"sourceDefinitionId": "b7c8d9e0-1f2a-4b3c-8d4e-5f6a7b8c9d0e",
"avatarUrl": null,
"verdict": "QUALIFIED",
"disqualifiedReason": null
}
],
"total": 41,
"page": 1,
"pageSize": 100
}coveragePct: qué parte del peso de los criterios tuvo evidencia. Lee el puntaje junto con este número.avatarUrl: link firmado a la foto, válido por una hora. Es lo único que se lee del perfil vivo.disqualifiedReason:FAILED_CRITERION(no cumple un criterio),INSUFFICIENT_DATA(no se pudo juzgar; vale la pena revisarlo) oNOT_RESPONSIVE.
GET /sourcing/longlists/{longlistId}/detail
/sourcing/longlists/{longlistId}/detailTodo lo que muestra el detalle de una longlist entregada, en una llamada: las entradas congeladas, el puntaje y el razonamiento de cada una, y cómo rindió cada búsqueda al armarla. Sin paginar.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| longlistId | uuid | Sí | La longlist. |
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | uuid | Sí | La vacante: el puntaje pertenece a la vacante. |
curl "https://app.reclee.com/api/v1/sourcing/longlists/e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b/detail?jobPostId=3f1c2a9e-7b4d-4e8a-9c21-5d6f7a8b9c01" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"entries": [{ "rank": 1, "profileId": "4b5c6d7e-8f90-4a1b-9c2d-3e4f5a6b7c8d", "scorePct": 82, "verdict": "QUALIFIED" }],
"scores": [{ "profileId": "4b5c6d7e-8f90-4a1b-9c2d-3e4f5a6b7c8d", "scorePct": 82, "coveragePct": 90, "verdict": "QUALIFIED", "criteria": [] }],
"searches": [
{
"searchDefinitionId": "b7c8d9e0-1f2a-4b3c-8d4e-5f6a7b8c9d0e",
"name": "Backend Go en Argentina",
"performancePct": 25,
"pulled": 120,
"qualified": 30
}
]
}entries tiene la forma de GET .../entries; scores, la de GET /sourcing/scores, sólo para las personas de la lista.
GET /sourcing/longlists/{longlistId}/panel
/sourcing/longlists/{longlistId}/panelUna longlist como la muestra el panel de Ask Reclee, en una sola llamada: su resumen, sus entradas y qué se sabe de los contactos de cada persona. De los contactos viaja solo el estado, nunca el email ni el teléfono. Devuelve null si la vacante no tiene esa longlist.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| longlistId | uuid | Sí | La longlist. |
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | uuid | Sí | La vacante de la longlist. |
curl "https://app.reclee.com/api/v1/sourcing/longlists/e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b/panel?jobPostId=3f1c2a9e-7b4d-4e8a-9c21-5d6f7a8b9c01" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"summary": {
"id": "e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b",
"status": "CLOSED_PARTIAL",
"targetSize": 50,
"qualified": 41,
"avgScorePct": 78.5,
"criteriaDiffer": false
},
"detail": {
"entries": [{ "rank": 1, "profileId": "4b5c6d7e-8f90-4a1b-9c2d-3e4f5a6b7c8d", "scorePct": 82, "verdict": "QUALIFIED" }],
"scores": [],
"searches": []
},
"contacts": {
"4b5c6d7e-8f90-4a1b-9c2d-3e4f5a6b7c8d": [
{ "type": "EMAIL_WORK", "status": "FOUND", "resolvedAt": "2026-09-23T10:12:00.000Z" },
{ "type": "PHONE", "status": "DISPATCHED", "resolvedAt": null }
]
}
}summary: la fila de la longlist, con la forma deGET /sourcing/longlists.detail: lo mismo queGET .../detail. Esnullmientras la corrida está abierta (OPEN): las entradas se congelan al cerrarse.contacts: porprofileId, los contactos conocidos de cada persona de la lista, contype(EMAIL_WORK,EMAIL_PERSONAL,PHONE),status(PENDING,DISPATCHED,FOUND,NOT_FOUND,FAILED) yresolvedAt. Los valores se leen conPOST /talent/contacts/states.
GET /sourcing/longlists/{longlistId}/searches
/sourcing/longlists/{longlistId}/searchesLas páginas de resultados de esta corrida, en orden, salgan de la definición que salgan. Cada fila tiene la forma de GET /sourcing/search-definitions/{definitionId}/searches.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| longlistId | uuid | Sí | La longlist. |
Pagina: devuelve { rows, total, page, pageSize }. Ver paginación.
curl "https://app.reclee.com/api/v1/sourcing/longlists/e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b/searches" \
-H "Authorization: Bearer $RECLEE_API_KEY"GET /sourcing/longlists/{longlistId}/export
/sourcing/longlists/{longlistId}/exportDescarga la longlist como CSV (UTF-8 con BOM, Content-Disposition: attachment). Una fila por persona con el puntaje y el veredicto congelados, los contactos conseguidos hasta hoy, datos del perfil y una columna por criterio (ordenadas por peso).
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| longlistId | uuid | Sí | La longlist. |
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | uuid | Sí | La vacante. |
| profileIds | string[] (separado por comas) | Opcional | Sólo estas personas. Conservan su rank original. |
curl "https://app.reclee.com/api/v1/sourcing/longlists/e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b/export?jobPostId=3f1c2a9e-7b4d-4e8a-9c21-5d6f7a8b9c01" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-o longlist.csvColumnas: rank, first_name, last_name, headline, company, city, linkedin_url, score_pct, coverage_pct, verdict, disqualified_reason, email_work, email_personal, phone, current_title, current_company, education, skills, languages y una por criterio.
Errores
NOT_FOUND(404): la longlist no existe, no la ves, o ninguna persona coincide conprofileIds.
GET /sourcing/searches/{searchId}/profiles
/sourcing/searches/{searchId}/profilesLos perfiles que trajo una página de resultados, en el orden en que llegaron, antes de enriquecer y puntuar. Sirve para explicar un rendimiento bajo. El cargo actual, la cantidad de experiencias y las skills sólo vienen si tu workspace ya enriqueció a esa persona.
Parámetros de ruta
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| searchId | uuid | Sí | La página de resultados (id de GET .../searches). |
Pagina: devuelve { rows, total, page, pageSize }. Ver paginación.
curl "https://app.reclee.com/api/v1/sourcing/searches/c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f/profiles" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"rows": [
{
"position": 1,
"profileId": "4b5c6d7e-8f90-4a1b-9c2d-3e4f5a6b7c8d",
"firstName": "Lucía",
"lastName": "Ferreyra",
"headline": "Senior Backend Engineer en Pagofácil Labs",
"linkedinUrl": "https://www.linkedin.com/in/lucia-ferreyra-ejemplo",
"enrichedAt": "2026-09-21T15:03:00.000Z",
"avatarUrl": null,
"currentRole": "Senior Backend Engineer · Pagofácil Labs",
"positionCount": 4,
"skills": ["Go", "PostgreSQL"]
}
],
"total": 20,
"page": 1,
"pageSize": 50
}avatarUrl es el link original de la foto y puede vencer solo.
Puntajes
El puntaje de una persona pertenece a la vacante: se calcula contra los criterios de sourcing vigentes. Cada criterio recibe un veredicto (GOOD_FIT, FIT, BAD_FIT o NO_DATA) con su motivo, y Reclee calcula el porcentaje con los pesos de los criterios. Si menos del 30 % del peso tiene evidencia, nadie califica.
GET /sourcing/scores
/sourcing/scoresTodos los puntajes vigentes de una vacante, cada uno con los criterios contra los que se juzgó y el razonamiento por criterio. Incluye a quienes no entraron a ninguna longlist.
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | uuid | Sí | La vacante. |
| profileIds | string[] (separado por comas) | Opcional | Sólo estas personas. Recomendado: una vacante tiene cientos de puntajes. |
| page | integer | Opcional | Página, desde 1. |
| pageSize | integer | Opcional | Filas por página, hasta 200. Default 50. |
Pagina: devuelve { rows, total, page, pageSize }. Ver paginación.
curl "https://app.reclee.com/api/v1/sourcing/scores?jobPostId=3f1c2a9e-7b4d-4e8a-9c21-5d6f7a8b9c01&profileIds=4b5c6d7e-8f90-4a1b-9c2d-3e4f5a6b7c8d" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"rows": [
{
"id": "9e8d7c6b-5a49-4382-9170-6f5e4d3c2b1a",
"profileId": "4b5c6d7e-8f90-4a1b-9c2d-3e4f5a6b7c8d",
"scorePct": 82,
"coveragePct": 90,
"verdict": "QUALIFIED",
"thresholdPct": 70,
"summary": "Fuerte en backend de pagos; sin experiencia en Kubernetes.",
"criteria": [
{
"criterionId": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"title": "5+ años en backend",
"value": "GOOD_FIT",
"reason": "Siete años como backend en dos fintech.",
"evidence": "Senior Backend Engineer, 2021–hoy",
"weightPct": 40,
"required": true
}
]
}
],
"total": 1,
"page": 1,
"pageSize": 50
}POST /sourcing/scores
/sourcing/scoresGuarda veredictos producidos por tu propio modelo. Mandas un veredicto por criterio; Reclee calcula el puntaje con los pesos y el umbral de la vacante, que no se exponen. Pide el trabajo pendiente con GET /sourcing/tasks. Devuelve { "scored": true }.
Body
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | uuid | Sí | La vacante. |
| profileId | uuid | Sí | La persona. Tu workspace tiene que haberla enriquecido. |
| evaluator | string | Sí | Qué produjo los veredictos (nombre del modelo o sistema), de 1 a 120 caracteres. |
| summary | string | Opcional | Resumen, hasta 1200 caracteres. Default vacío. |
| verdicts | object[] | Sí | Uno por cada criterio vigente: criterionId (uuid), value ('GOOD_FIT', 'FIT', 'BAD_FIT' o 'NO_DATA'), reason (1 a 600 caracteres, obligatorio) y evidence (hasta 600, opcional). |
curl -X POST "https://app.reclee.com/api/v1/sourcing/scores" \
-H "Authorization: Bearer $RECLEE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jobPostId": "3f1c2a9e-7b4d-4e8a-9c21-5d6f7a8b9c01",
"profileId": "4b5c6d7e-8f90-4a1b-9c2d-3e4f5a6b7c8d",
"evaluator": "acme-screening-v2",
"verdicts": [
{
"criterionId": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"value": "GOOD_FIT",
"reason": "Siete años como backend en dos fintech.",
"evidence": "Senior Backend Engineer, 2021–hoy"
}
]
}'Errores
UNKNOWN_CRITERION(400): uncriterionIdno es de esta vacante.INCOMPLETE(400): faltan veredictos; tiene que haber uno por cada criterio vigente.NOT_ENRICHED(409): la persona no está enriquecida, así que no había nada que leer.NO_CRITERIA(409): la vacante no tiene criterios de sourcing.NOT_FOUND(404): la vacante o la persona no existen o no las ves.SEAT_REQUIRED(403): hace falta un asiento.
Tareas
GET /sourcing/tasks
/sourcing/tasksEl trabajo para puntuar con tu propio modelo: la vacante, los criterios vigentes y los perfiles (ya enriquecidos) que todavía no tienen un puntaje vigente con esos criterios. No incluye pesos: devuelves un veredicto por criterio con POST /sourcing/scores y Reclee calcula el número. Un puntaje que quedó viejo porque cambiaron los criterios vuelve a la cola.
Parámetros de query
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| jobPostId | uuid | Sí | La vacante. |
| limit | integer | Opcional | Cuántos perfiles devolver, de 1 a 100. Default 20. |
curl "https://app.reclee.com/api/v1/sourcing/tasks?jobPostId=3f1c2a9e-7b4d-4e8a-9c21-5d6f7a8b9c01&limit=10" \
-H "Authorization: Bearer $RECLEE_API_KEY"Respuesta (extracto)
{
"jobPostId": "3f1c2a9e-7b4d-4e8a-9c21-5d6f7a8b9c01",
"vacancy": {
"title": "Senior Backend Engineer",
"description": "Buscamos a alguien para liderar el equipo de pagos.",
"seniority": "MID_SENIOR_LEVEL",
"employmentType": "FULL_TIME",
"workplaceType": "REMOTE",
"country": "AR",
"city": null
},
"thresholdPct": 70,
"criteria": [
{
"id": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"title": "5+ años en backend",
"description": null,
"required": true
}
],
"profiles": [
{ "profileId": "4b5c6d7e-8f90-4a1b-9c2d-3e4f5a6b7c8d", "profile": { "…": "registro enriquecido" } }
],
"remaining": 37
}profile es el registro enriquecido completo, tal como se puntúa en Reclee. remaining cuenta los perfiles que siguen esperando además de los entregados.
Errores
NO_CRITERIA(409): la vacante no tiene criterios de sourcing.NOT_FOUND(404): la vacante no existe o no la ves.