US$ 5 grátis Por tempo limitado. Cadastre-se para ativar. Resgate seus US$ 5 →

Ofereça a busca de pessoas como ferramenta de agente

Permita que um agente encontre as pessoas que ocupam um cargo em uma empresa-alvo e leia seus perfis, como uma ferramenta de busca com filtros tipados, e não uma sessão de navegação.

  • Chave de API gratuita
  • Sem cartão de crédito
  • Rode sua amostra

Uma seleção de equipes que executam esse trabalho na Forager · e outras equipes que usam a Forager

  • Clay
  • Juicebox
  • Nooks
  • Emergent Labs
  • Deepline
  • HubSpot
  • BetterContact
  • Salto

Usa POST /person_role_search/, POST /person_detail_lookup/ · Referência da API de busca de pessoas

Quanto custa: cobrado por requisição: preços por crédito.

Como os dados fluem

3 entradas → Busca de pessoas + Enriquecimento de pessoas → 5 campos dados de exemplo
01 · Entradas
Domínio da empresa
example.com
Cargo
VP de Revenue Operations
localização
linkedin.com/in/priya-fixture
02 · Forager
Busca de pessoas + Enriquecimento de pessoas POST /person_role_search/
Correspondência encontrada
03 · Saídas
Priya FixtureVP de Revenue Operations · Example Inc.
person id
per_8f3a1c
title
VP de Revenue Operations
empregador
Example Inc.
campos do perfil
/in/priya-fixture
nome
Priya Fixture
celular
+44 20 7946 0958
5 campos na respostadados de exemplo

Passos

  1. Exponha uma ferramenta find_people que mapeia a requisição do agente para filtros de POST /person_role_search/: cargo, senioridade, departamento, localização e empresa
  2. Verifique primeiro o endpoint _totals para a ferramenta informar quantas correspondências existem antes de paginar
  3. Retorne cada correspondência como um registro tipado com person_id, nome, cargo e empregador
  4. Deixe o agente chamar POST /person_detail_lookup/ para a pessoa ou as duas pessoas que ele escolher, não para todo o 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)
Gerado a partir das etapas do exemplo práticoCampos da requisição: referência da API

Execute você mesmo: Referência da API de busca de pessoas

  • Chave de API gratuita
  • Sem cartão de crédito
  • Rode sua amostra

Entradas e saídas

Dados de entradaSaídas
domínio ou nome da empresaperson_id
filtros de cargo ou senioridadefull name
localizaçãotitle
employer
profile fields

Dúvidas sobre esta receita

Como meu agente pode buscar pessoas por cargo em uma empresa?

Exponha uma ferramenta find_people que mapeia a requisição do agente para os filtros de POST /person_role_search/: cargo, senioridade, departamento, localização e empresa. Deixe o agente chamar POST /person_detail_lookup/ para a ou as duas pessoas que ele escolher, não para todo o conjunto de resultados.

Quanto custa oferecer a busca de pessoas como ferramenta de agente?

Busca de pessoas: 1 crédito por requisição; busca de pessoas: detalhes do cargo: 1 crédito por requisição, cobrados com ou sem retorno de dados. Enriquecimento de pessoas: 1 crédito por requisição, cobrado com ou sem retorno de dados. Os 8.250 créditos mensais do plano Growth cobrem 8.250 requisições de busca, ou uma combinação. Os planos self-service são Starter, Growth, Pro e Scale. Veja planos e preços

O que preciso para executar este exemplo prático e o que recebo de volta?

Você envia o domínio ou o nome da empresa, a localização e filtros de cargo ou senioridade. Você recebe empregador, nome completo, person_id e campos do perfil, em JSON. Você também precisa de uma chave de API da Forager, que vem com uma conta gratuita.

Qual API de busca de pessoas retorna resultados tipados que um agente consegue usar?

Este exemplo prático usa Busca de pessoas e Enriquecimento de pessoas da Forager. Busca de pessoas: encontre as pessoas que ocupam um cargo em empresas-alvo, com filtros por cargo, senioridade, departamento e localização. Deixe um agente encontrar as pessoas que ocupam um cargo em uma empresa-alvo e ler os perfis, como uma ferramenta de busca com filtros tipados em vez de uma sessão de navegação.

Existe um jeito gratuito de testar a Forager neste fluxo de trabalho?

Sim. Crie uma conta gratuita em app.forager.ai: ela vem com US$ 5 em créditos gratuitos e uma chave de API, e não é preciso cartão de crédito para se cadastrar. Teste com registros que você já conhece ou agende uma demo e envie uma lista: nós a processamos e mostramos o que encontramos.

Quando devo executar este fluxo de trabalho?

Um agente recebe o pedido de encontrar o responsável por segurança em uma lista de empresas e iniciar uma conversa com cada um. O agente encontra a pessoa certa em uma única chamada de ferramenta, e a plataforma paga pelos perfis que abre, não pela busca.

Quais produtos da Forager este exemplo prático usa?

Busca de pessoas e enriquecimento de pessoas. Busca de pessoas: encontre as pessoas que ocupam um cargo em empresas-alvo, com filtros de cargo, senioridade, departamento e localização. Enriquecimento de pessoas: perfil profissional completo de uma pessoa a partir de uma URL do LinkedIn, e-mail ou telefone: experiência, formação, habilidades e canais de contato.

Como sei que os dados estão corretos?

O teste que vale é o seu: envie uma lista de perfis que importam para você. Nós rodamos e mostramos o que encontramos, número por número, para você mesmo medir a taxa de acerto e a taxa de conexão.

Como encontrar tomadores de decisão em uma ferramenta de agente?

Exponha uma ferramenta find_people que mapeie a requisição do agente para os filtros de POST /person_role_search/: cargo, senioridade, departamento, localização e empresa. Consulte antes o endpoint _totals para que a ferramenta informe quantas correspondências existem antes de paginar.

Quais ferramentas podem executar este fluxo de trabalho?

Integração nativa no Clay, criada por parceiros na Deepline e no Cargo e chamada pela API a partir do seu próprio código, do Make e do n8n. Ou chame os endpoints das etapas acima a partir do seu código com uma única chave de API.

Quantas etapas tem este fluxo de trabalho?

4 etapas: exponha uma ferramenta find_people que mapeie a requisição do agente para os filtros de POST /person_role_search/: cargo, senioridade, departamento, localização e empresa, consulte antes o endpoint _totals para que a ferramenta informe quantas correspondências existem antes de paginar, retorne cada correspondência como um registro tipado com person_id, nome, cargo e empregador e deixe o agente chamar POST /person_detail_lookup/ para a pessoa ou as duas que ele escolher, não para todo o conjunto de resultados.

Existe contrato ou compromisso mínimo?

Sem contrato para começar: uma conta gratuita vem com US$ 5 em créditos. Para continuar usando a Forager, escolha um plano mensal ou anual. Os planos mensais podem ser cancelados a qualquer momento e os créditos não usados são acumulados; os planos anuais liberam todos os créditos de uma vez e custam 10% menos. Volumes maiores são combinados com nossa equipe.

Uma seleção de equipes que executam esse trabalho na Forager · e outras equipes que usam a Forager

  • Clay
    • Construtores de workflows de GTM

    Caso de uso selecionado: números de celular, e-mails e dados de pessoas da Forager dentro de tabelas do Clay.

  • Juicebox
    • Sourcing de candidatos com IA

    Caso de uso selecionado: dados da Forager por trás da busca PeopleGPT e dos agentes de sourcing.

  • Nooks
    • Discadores power e paralelos

    Caso de uso selecionado: números de celular dentro do próprio discador (dialer).

  • Emergent Labs
    • Criadores de agentes

    Plataforma de criação de apps com IA em que agentes projetam, programam e fazem o deploy de apps full-stack.

  • Deepline
    • Enriquecimento em cascata (waterfall)

    Caso de uso selecionado: consultas da Forager como ferramentas tipadas dentro de waterfalls de enriquecimento.

    19 ferramentas tipadas da Forager disponíveis na Deepline1

  • HubSpot
    • Complementos de CRM

    Caso de uso selecionado: enriquecer registros de contatos e empresas com dados de pessoas, empresas e vagas de emprego.

  • BetterContact
    • Enriquecimento em cascata (waterfall)

    Caso de uso selecionado: uma etapa da Forager na cascata (waterfall) para números de celular.

  • Salto
    • Uso interno

    Plataforma de alterações de configuração com governança em sistemas empresariais.

Fontes

1 Deepline: deepline.com/integrations/forager (página pública, consultada em 2026-10-21).

Comece a desenvolver

Coloque no seu produto dados acionáveis de pessoas, empresas e vagas para seus usuários

Envie uma lista. Nós a processamos, mostramos o que encontramos e depois conversamos sobre volume e condições.

  • US$ 5 em créditos grátis
  • Sem cartão de crédito
  • Rode sua amostra
Plataformas e equipes que desenvolvem com a Forager
  • Clay
  • Juicebox
  • Nooks
  • Andela
  • HubSpot
  • SeekOut