Ofrece la búsqueda de personas como herramienta para agentes
Permite que un agente encuentre a las personas que ocupan un cargo en una empresa objetivo y lea sus perfiles, como una herramienta de búsqueda con filtros tipados en lugar de una sesión de navegación.
- Clave de API gratuita
- Sin tarjeta de crédito
- Ejecuta tu muestra
Una selección de equipos que ejecutan este trabajo con Forager · y otros equipos que usan Forager
Usa POST /person_role_search/, POST /person_detail_lookup/ · Referencia de la API de búsqueda de personas
Cuánto cuesta: Se cobra por solicitud: precios de créditos.
- Búsqueda de personas
- Enriquecimiento de personas
- API
- Integrado en una plataforma
- Agentes de IA y herramientas para desarrolladores
Cómo fluyen los datos
POST /person_role_search/ - person id
- per_8f3a1c
- cargo
- VP Revenue Operations
- empleador
- Example Inc.
- campos del perfil
- /in/priya-fixture
- nombre
- Priya Fixture
- móvil
- +44 20 7946 0958
Pasos
- Expón una herramienta
find_peopleque asigne la solicitud del agente a filtros dePOST /person_role_search/: cargo, seniority, departamento, ubicación y empresa - Consulta primero el endpoint _totals para que la herramienta pueda informar de cuántas coincidencias existen antes de paginar
- Devuelve cada coincidencia como un registro tipado con
person_id, nombre, cargo y empleador - Deja que el agente llame a
POST /person_detail_lookup/solo para las 1 o 2 personas que elija, no para todo el conjunto de resultados
import json, os, requests BASE = "https://api-v2.forager.ai/api/{account_id}/datastorage" HEADERS = {"X-API-KEY": os.environ["FORAGER_KEY"]} body = json.load(open("request.json")) # request fields: see the API reference # 1. Expose a find_people tool that maps the agent's request to POST # /person_role_search/ filters: title, seniority, department, location and # company r1 = requests.post(f"{BASE}/person_role_search/", headers=HEADERS, json=body) # 2. Check the _totals endpoint first so the tool can report how many # matches exist before it pages # 3. Return each match as a typed record with person_id, name, title and # employer # 4. Let the agent call POST /person_detail_lookup/ for the one or two # people it chooses, not the whole result set r2 = requests.post(f"{BASE}/person_detail_lookup/", headers=HEADERS, json=body)
# 1. POST /person_role_search/ curl -X POST \ https://api-v2.forager.ai/api/{account_id}/datastorage/person_role_search/ \ -H "X-API-KEY: $FORAGER_KEY" \ -H "Content-Type: application/json" \ -d @request.json # 2. POST /person_detail_lookup/ curl -X POST \ https://api-v2.forager.ai/api/{account_id}/datastorage/person_detail_lookup/ \ -H "X-API-KEY: $FORAGER_KEY" \ -H "Content-Type: application/json" \ -d @request.json
Pruébalo tú mismo: Referencia de la API de búsqueda de personas
- Clave de API gratuita
- Sin tarjeta de crédito
- Ejecuta tu muestra
Entradas y salidas
| Datos de entrada | Resultados |
|---|---|
| dominio o nombre de la empresa | person_id |
| filtros de cargo o nivel jerárquico | full name |
| ubicación | title |
employer | |
profile fields |
Preguntas sobre este ejemplo práctico
¿Cómo puede mi agente buscar personas por cargo en una empresa?
Expón una herramienta find_people que convierta la solicitud del agente en filtros de POST /person_role_search/: puesto, antigüedad, departamento, ubicación y empresa. Deja que el agente llame a POST /person_detail_lookup/ solo para las una o dos personas que elija, no para todo el conjunto de resultados.
¿Cuánto cuesta ofrecer la búsqueda de personas como herramienta de agente?
Búsqueda de personas: búsqueda de personas 1 crédito por solicitud y búsqueda de personas: detalles del cargo 1 crédito por solicitud, cobrados haya o no datos en la respuesta. Enriquecimiento de personas: 1 crédito por solicitud, cobrado haya o no datos en la respuesta. Los 8.250 créditos mensuales de Growth cubren 8.250 solicitudes de búsqueda, o una combinación. Los planes de autoservicio son Starter, Growth, Pro y Scale. Ver planes y precios
¿Qué necesito para ejecutar este ejemplo práctico y qué devuelve?
Envías el dominio o nombre de la empresa, la ubicación y filtros de cargo o nivel jerárquico. Recibes el empleador, el nombre completo, el person_id y los campos del perfil, en JSON. También necesitas una clave de API de Forager, que viene con una cuenta gratuita.
¿Qué API de búsqueda de personas devuelve resultados tipados que un agente pueda usar?
Este ejemplo práctico usa Búsqueda de personas y Enriquecimiento de personas de Forager. Búsqueda de personas: encuentra a las personas que ocupan un cargo en empresas objetivo, filtradas por cargo, nivel jerárquico, departamento y ubicación. Deja que un agente encuentre a las personas que ocupan un cargo en una empresa objetivo y lea sus perfiles, como una herramienta de búsqueda con filtros tipados en lugar de una sesión de navegación.
¿Hay una forma gratuita de probar Forager en este flujo de trabajo?
Sí. Crea una cuenta gratuita en app.forager.ai: incluye 5 $ en créditos gratis y una clave de API, y no hace falta tarjeta de crédito para registrarte. Pruébalo con registros que ya conozcas, o reserva una demo y envíanos una lista: la procesamos y te mostramos lo que encontramos.
¿Cuándo debería ejecutar este flujo de trabajo?
Se le pide a un agente que encuentre al responsable de seguridad de una lista de empresas y que inicie una conversación con cada uno. El agente encuentra a la persona adecuada en una sola llamada a la herramienta, y la plataforma paga por los perfiles que abre, no por la búsqueda.
¿Qué productos de Forager usa este ejemplo práctico?
Búsqueda de personas y enriquecimiento de personas. Búsqueda de personas: encuentra a quienes ocupan un cargo en las empresas objetivo, filtrando por puesto, antigüedad, departamento y ubicación. Enriquecimiento de personas: un perfil profesional completo de una persona a partir de una URL de LinkedIn, email o teléfono: experiencia, formación, habilidades y canales de contacto.
¿Cómo sé que los datos son correctos?
La prueba que cuenta es la tuya: envía una lista de perfiles que te interesen. La ejecutamos y te mostramos lo que encontramos, número por número, para que puedas medir tú la tasa de aciertos y la tasa de conexión.
¿Cómo encuentro a los decisores con una herramienta para agentes?
Expón una herramienta find_people que asigne la solicitud del agente a los filtros de POST /person_role_search/: cargo, nivel jerárquico, departamento, ubicación y empresa. Consulta primero el endpoint _totals para que la herramienta pueda informar cuántas coincidencias existen antes de paginar.
¿Qué herramientas pueden ejecutar este flujo de trabajo?
Nativo en Clay, creado por partners en Deepline y Cargo, y disponible a través de la API desde tu propio código, Make y n8n. O llama a los endpoints de los pasos anteriores desde tu propio código con una sola clave de API.
¿Cuántos pasos tiene este flujo de trabajo?
4 pasos: expón una herramienta find_people que asigne la solicitud del agente a los filtros de POST /person_role_search/: cargo, nivel jerárquico, departamento, ubicación y empresa; consulta primero el endpoint _totals para que la herramienta pueda informar cuántas coincidencias existen antes de paginar; devuelve cada coincidencia como un registro tipado con person_id, nombre, cargo y empleador; y deja que el agente llame a POST /person_detail_lookup/ solo para la una o dos personas que elija, no para todo el conjunto de resultados.
¿Hay contrato o compromiso mínimo?
Sin contrato para empezar: una cuenta gratuita incluye 5 $ en créditos. Para seguir usando Forager, elige un plan mensual o anual. Los planes mensuales se cancelan en cualquier momento y los créditos no usados se acumulan; los planes anuales conceden todos los créditos por adelantado y cuestan un 10 % menos. Los volúmenes mayores se acuerdan con nuestro equipo.
Las respuestas escritas no están disponibles ahora mismo. Las páginas de arriba siguen sirviendo, o reserva una demo y pregunta al equipo.
- 5 $ en créditos gratis
- Sin tarjeta de crédito
- Ejecuta tu muestra
Una selección de equipos que ejecutan este trabajo con Forager · y otros equipos que usan ForagerUna selección de equipos que usan Forager
-
Clay - Creadores de flujos GTM
Caso de uso seleccionado: números de móvil, emails y datos de personas de Forager dentro de tablas de Clay.
-
Juicebox - Captación de candidatos con IA
Caso de uso seleccionado: datos de Forager detrás de su búsqueda PeopleGPT y sus agentes de captación.
-
Nooks - Marcadores power y paralelos
Caso de uso seleccionado: números de móvil dentro de su marcador (dialer).
-
Emergent Labs - Creadores de agentes
Plataforma de creación de apps con IA donde los agentes diseñan, programan y despliegan apps full-stack.
-
Deepline - Enriquecimiento en cascada
Caso de uso seleccionado: consultas de Forager como herramientas tipadas dentro de enriquecimientos en cascada.
19 herramientas tipadas de Forager disponibles en Deepline1
-
HubSpot - Complementos de CRM
Caso de uso seleccionado: enriquecer registros de contactos y empresas con datos de personas, empresas y ofertas de empleo.
-
BetterContact - Enriquecimiento en cascada
Caso de uso seleccionado: un paso de Forager en su cascada para números de móvil.
-
Salto - Uso interno
Plataforma para cambios de configuración gobernados en sistemas de negocio.
Fuentes
1 Deepline: deepline.com/integrations/forager (página pública, consultada el 21 de octubre de 2026).
Más ejemplos prácticos para creadores de agentes
-
Da a los agentes de programación herramientas tipadas de datos de personas y empresas
-
Ofrece datos de personas y empresas como integración incorporada en un creador de apps con IA
-
Añade Forager a la cascada de contactos de un agente
-
Basa la investigación de cuentas de un agente en el enriquecimiento de empresas
-
Detecta contactos del CRM que han cambiado de empleo y avisa cuando tus champions cambien de empresa
-
Refuerza una base de datos de inteligencia comercial con una fuente adicional de móviles
