Proposez la recherche de personnes comme outil d’agent

Laissez un agent trouver les personnes qui occupent un poste dans une entreprise cible et lire leurs profils, via un outil de recherche à filtres typés plutôt qu’une session de navigation.

Obtenir une clé API gratuite + 5 $Recevoir un test sur échantillon

Clé API gratuite
Sans carte bancaire
Lancez votre échantillon

Une sélection d’équipes qui font ce travail avec Forager · et d’autres équipes sur Forager

Utilise POST /person_role_search/, POST /person_detail_lookup/ · Référence de l’API de recherche de personnes

Coût : Décompté par requête : tarifs des crédits.

Comment circulent les données

3 entrées → Recherche de personnes + Enrichissement de personnes → 5 champs données d’exemple

01 · Entrées

Domaine de l’entreprise

example.com

Poste

VP Revenue Operations

localisation

linkedin.com/in/priya-fixture

02 · Forager

Recherche de personnes + Enrichissement de personnes POST /person_role_search/

Correspondance trouvée

03 · Sorties

Priya FixtureVP Revenue Operations · Example Inc.

ID de personne: per_8f3a1c
title: VP Revenue Operations
employeur: Example Inc.
champs de profil: /in/priya-fixture
name: Priya Fixture
mobile: +44 20 7946 0958

5 champs dans la réponsedonnées d’exemple

Étapes

Exposez un outil find_people qui convertit la demande de l’agent en filtres POST /person_role_search/ : poste, ancienneté, service, lieu et entreprise
Appelez d’abord l’endpoint _totals pour que l’outil indique combien de correspondances existent avant de paginer
Renvoyez chaque correspondance sous forme d’enregistrement typé avec person_id, le nom, l’intitulé de poste et l’employeur
Laissez l’agent appeler POST /person_detail_lookup/ pour la ou les deux personnes qu’il choisit, pas pour tout l’ensemble des résultats

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

Généré à partir des étapes de l’exemple pratiqueChamps de la requête : référence API

Essayez-le vous-même : Référence de l’API de recherche de personnes

Obtenir une clé API gratuite + 5 $Recevoir un test sur échantillon

Clé API gratuite
Sans carte bancaire
Lancez votre échantillon

Entrées et sorties

Données d’entrée	Résultats
domaine ou nom de l’entreprise	`person_id`
filtres d’intitulé de poste ou d’ancienneté	`full name`
localisation	`title`
	`employer`
	`profile fields`

Questions sur cet exemple pratique

Comment mon agent peut-il rechercher des personnes par poste dans une entreprise ?

Exposez un outil find_people qui traduit la demande de l’agent en filtres POST /person_role_search/ : intitulé de poste, ancienneté, service, localisation et entreprise. Laissez l’agent appeler POST /person_detail_lookup/ pour la ou les deux personnes qu’il choisit, pas pour tout l’ensemble de résultats.

Combien coûte la recherche de personnes comme outil d’agent ?

Recherche de personnes : 1 crédit par requête, et recherche de personnes : détails du poste : 1 crédit par requête, décomptés que des données soient renvoyées ou non. Enrichissement de personnes : 1 crédit par requête, décompté que des données soient renvoyées ou non. Les 8 250 crédits mensuels du plan Growth couvrent 8 250 requêtes de recherche, ou un mélange. Les plans en libre-service sont Starter, Growth, Pro et Scale. Voir les plans et les tarifs

Que faut-il pour mettre en place cet exemple pratique, et que renvoie-t-il ?

Vous envoyez un domaine ou un nom d’entreprise, la localisation et des filtres d’intitulé de poste ou d’ancienneté. Vous recevez l’employeur, le nom complet, person_id et des champs de profil, au format JSON. Il vous faut aussi une clé API Forager, fournie avec un compte gratuit.

Quelle API de recherche de personnes renvoie des résultats typés exploitables par un agent ?

Cet exemple pratique utilise la recherche de personnes et l’enrichissement de personnes de Forager. Recherche de personnes : trouvez les personnes qui occupent un poste dans des entreprises cibles, filtrées par intitulé de poste, ancienneté, service et localisation. Permettez à un agent de trouver les personnes qui occupent un poste dans une entreprise cible et de lire leurs profils, avec un outil de recherche à filtres typés plutôt qu’une session de navigation.

Existe-t-il un moyen gratuit d’essayer Forager sur ce parcours ?

Oui. Créez un compte gratuit sur app.forager.ai : il inclut 5 $ de crédits gratuits et une clé API, sans carte bancaire pour vous inscrire. Testez-le sur des enregistrements que vous connaissez déjà, ou réservez une démo et envoyez-nous une liste : nous la traitons et vous montrons ce que nous trouvons.

Quand exécuter ce parcours ?

On demande à un agent de trouver le responsable sécurité d’une liste d’entreprises et d’engager la conversation avec chacun. L’agent trouve la bonne personne en un seul appel d’outil, et la plateforme paie les profils qu’elle ouvre, pas la recherche.

Quels produits Forager cet exemple pratique utilise-t-il ?

Recherche de personnes et enrichissement de personnes. Recherche de personnes : trouvez les personnes qui occupent un poste dans des entreprises cibles, filtrées par intitulé de poste, ancienneté, service et localisation. Enrichissement de personnes : un profil professionnel complet à partir d’une URL LinkedIn, d’un e-mail ou d’un numéro de téléphone : expérience, formation, compétences et canaux de contact.

Comment savoir si les données sont justes ?

Le test qui compte est le vôtre : envoyez une liste de profils qui vous intéressent. Nous la traitons et vous montrons ce que nous trouvons, numéro par numéro, pour que vous mesuriez vous-même le taux de correspondance et le taux de connexion.

Comment trouver des décideurs avec un outil pour agent ?

Exposez un outil find_people qui traduit la demande de l’agent en filtres POST /person_role_search/ : intitulé de poste, ancienneté, service, localisation et entreprise. Appelez d’abord l’endpoint _totals pour que l’outil indique combien de résultats existent avant de paginer.

Quels outils peuvent exécuter ce parcours ?

Natif dans Clay, développé par des partenaires dans Deepline et Cargo, et appelé via l’API depuis votre propre code, Make et n8n. Ou appelez les endpoints des étapes ci-dessus depuis votre propre code avec une seule clé API.

Combien d’étapes compte ce parcours ?

4 étapes : exposez un outil find_people qui traduit la demande de l’agent en filtres POST /person_role_search/ : intitulé de poste, ancienneté, service, localisation et entreprise ; consultez d’abord l’endpoint _totals pour que l’outil indique combien de résultats existent avant de paginer ; renvoyez chaque résultat sous forme d’enregistrement typé avec person_id, name, title et employer ; laissez l’agent appeler POST /person_detail_lookup/ pour les une ou deux personnes qu’il choisit, pas pour tout le jeu de résultats.

Y a-t-il un contrat ou un engagement minimum ?

Aucun engagement pour démarrer : un compte gratuit inclut 5 $ de crédits. Pour continuer à utiliser Forager, choisissez un plan mensuel ou annuel. Les plans mensuels sont résiliables à tout moment et les crédits inutilisés sont reportés ; les plans annuels accordent tous les crédits d’emblée et coûtent 10 % de moins. Les volumes plus importants se définissent avec notre équipe.

Une sélection d’équipes qui font ce travail avec Forager · et d’autres équipes sur Forager

Clay
- Constructeurs de workflows GTM
Cas d’usage sélectionné : numéros de mobile, e-mails et données de personnes Forager dans des tables Clay.
Juicebox
- Sourcing de candidats par IA
Cas d’usage sélectionné : les données Forager derrière sa recherche PeopleGPT et ses agents de sourcing.
Nooks
- Power et parallel dialers
Cas d’usage sélectionné : des numéros de mobile dans leur outil de numérotation (dialer).
Emergent Labs
- Créateurs d’agents
Plateforme de création d’applications IA où des agents conçoivent, codent et déploient des applications full-stack.
Deepline
- Enrichissement en cascade (waterfall)
Cas d’usage retenu : consultations Forager comme outils typés dans des enrichissements en cascade (waterfall).

19 outils Forager typés disponibles dans Deepline¹
HubSpot
- Modules CRM
Cas d’usage sélectionné : enrichir les enregistrements de contacts et d’entreprises avec des données de personnes, d’entreprises et d’offres d’emploi.
BetterContact
- Enrichissement en cascade (waterfall)
Cas d’usage sélectionné : une étape Forager dans son enrichissement en cascade (waterfall) de numéros de mobile.
Salto
- Usage interne
Plateforme de modifications de configuration encadrées entre systèmes métier.

Sources

¹ Deepline : deepline.com/integrations/forager (page publique, consultée le 21 octobre 2026).

Voir aussi

Proposez la recherche de personnes comme outil d’agent

Comment circulent les données

Étapes

Entrées et sorties

Questions sur cet exemple pratique

Comment mon agent peut-il rechercher des personnes par poste dans une entreprise ?

Combien coûte la recherche de personnes comme outil d’agent ?

Que faut-il pour mettre en place cet exemple pratique, et que renvoie-t-il ?

Quelle API de recherche de personnes renvoie des résultats typés exploitables par un agent ?

Existe-t-il un moyen gratuit d’essayer Forager sur ce parcours ?

Quand exécuter ce parcours ?

Quels produits Forager cet exemple pratique utilise-t-il ?

Comment savoir si les données sont justes ?

Comment trouver des décideurs avec un outil pour agent ?

Quels outils peuvent exécuter ce parcours ?

Combien d’étapes compte ce parcours ?

Y a-t-il un contrat ou un engagement minimum ?

Plus d’exemples pratiques pour les créateurs d’agents

Donner aux agents de code des outils typés de données de personnes et d’entreprises

Proposer les données de personnes et d’entreprises comme intégration native dans un créateur d’applications IA

Ajoutez Forager à la cascade d’un outil de contact d’agent

Ancrez la recherche de comptes d’un agent grâce à l’enrichissement d’entreprises

Détecter les contacts CRM qui ont changé de poste et alerter sur les champions partis ailleurs

Compléter une base de sales intelligence avec une source de mobiles supplémentaire

Intégrez à votre produit des données de personnes, d’entreprises et d’offres d’emploi que vos utilisateurs peuvent exploiter