Personensuche als Agent-Tool anbieten

Lassen Sie einen Agenten die Personen finden, die bei einem Zielunternehmen eine bestimmte Position innehaben, und ihre Profile lesen – als Suchtool mit typisierten Filtern statt als Browsing-Sitzung.

Kostenlosen API-Schlüssel + 5 $ sichern Beispieldurchlauf anfordern

Kostenloser API-Schlüssel
Keine Kreditkarte
Testlauf starten

Eine Auswahl von Teams, die diese Aufgabe mit Forager umsetzen · plus weitere Teams, die Forager nutzen

Nutzt POST /person_role_search/, POST /person_detail_lookup/ · API-Referenz zur Personensuche

Kosten: Berechnung pro Anfrage: Credit-Preise.

So fließen die Daten

3 Eingaben → Personensuche + Personenanreicherung → 5 Felder Beispieldaten

01 · Eingaben

Unternehmensdomain

example.com

Jobtitel

VP Revenue Operations

Standort

linkedin.com/in/priya-fixture

02 · Forager

Personensuche + Personenanreicherung POST /person_role_search/

Treffer gefunden

03 · Ausgaben

Priya FixtureVP Revenue Operations · Example Inc.

person id: per_8f3a1c
title: VP Revenue Operations
Arbeitgeber: Example Inc.
Profilfelder: /in/priya-fixture
Name: Priya Fixture
Mobil: +44 20 7946 0958

5 Felder in der AntwortBeispieldaten

Schritte

Stellen Sie ein find_people-Tool bereit, das die Anfrage des Agenten auf POST /person_role_search/-Filter abbildet: Jobtitel, Seniorität, Abteilung, Standort und Unternehmen
Prüfen Sie zuerst den _totals-Endpoint, damit das Tool melden kann, wie viele Treffer es gibt, bevor es die Seiten abruft
Geben Sie jeden Treffer als typisierten Datensatz mit person_id, Name, Jobtitel und Arbeitgeber zurück
Lassen Sie den Agenten POST /person_detail_lookup/ nur für die ein oder zwei Personen aufrufen, die er auswählt, nicht für den gesamten Ergebnissatz

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

Aus den Schritten des Praxisbeispiels generiertAnfragefelder: API-Referenz

Selbst ausführen: API-Referenz zur Personensuche

Kostenlosen API-Schlüssel + 5 $ sichern Beispieldurchlauf anfordern

Kostenloser API-Schlüssel
Keine Kreditkarte
Testlauf starten

Eingaben und Ausgaben

Eingaben	Ergebnisse
Unternehmensdomain oder -name	`person_id`
Filter nach Jobtitel oder Seniorität	`full name`
Standort	`title`
	`employer`
	`profile fields`

Fragen zu diesem Praxisbeispiel

Wie kann mein Agent nach Personen mit einer bestimmten Position in einem Unternehmen suchen?

Stellen Sie ein find_people-Tool bereit, das die Anfrage des Agenten auf die Filter von POST /person_role_search/ abbildet: Jobtitel, Seniorität, Abteilung, Standort und Unternehmen. Lassen Sie den Agenten POST /person_detail_lookup/ nur für die ein oder zwei Personen aufrufen, die er auswählt, nicht für die gesamte Ergebnismenge.

Was kostet es, Personensuche als Agent-Tool anzubieten?

Personensuche: Personensuche 1 Credit pro Anfrage und Personensuche: Positionsdetails 1 Credit pro Anfrage, berechnet, unabhängig davon, ob Daten zurückkommen. Personenanreicherung: 1 Credit pro Anfrage, berechnet, unabhängig davon, ob Daten zurückkommen. Mit den 8.250 monatlichen Credits des Tarifs Growth sind 8.250 Suchanfragen oder ein Mix möglich. Self-Service-Tarife sind Starter, Growth, Pro und Scale. Tarife und Preise ansehen

Was brauche ich für dieses Praxisbeispiel und was kommt zurück?

Sie senden Unternehmensdomain oder -name, Standort sowie Filter für Jobtitel oder Seniorität. Sie erhalten Arbeitgeber, vollständigen Namen, person_id und Profilfelder als JSON zurück. Außerdem benötigen Sie einen Forager-API-Schlüssel, der in einem kostenlosen Konto enthalten ist.

Welche API für die Personensuche liefert typisierte Ergebnisse, die ein Agent nutzen kann?

Dieses Praxisbeispiel nutzt Forager Personensuche und Personenanreicherung. Personensuche: Finden Sie die Personen, die bei Zielunternehmen eine Position innehaben, gefiltert nach Jobtitel, Seniorität, Abteilung und Standort. Lassen Sie einen Agenten die Personen finden, die bei einem Zielunternehmen eine Position innehaben, und ihre Profile lesen: als Suchtool mit typisierten Filtern statt als Browsing-Sitzung.

Gibt es eine kostenlose Möglichkeit, Forager für diesen Workflow auszuprobieren?

Ja. Erstellen Sie ein kostenloses Konto unter app.forager.ai: Es enthält 5 $ an kostenlosen Credits und einen API-Schlüssel, und für die Anmeldung ist keine Kreditkarte nötig. Testen Sie es mit Datensätzen, die Sie bereits kennen, oder buchen Sie eine Demo und senden Sie uns eine Liste: Wir führen den Test durch und zeigen Ihnen, was wir finden.

Wann sollte ich diesen Workflow ausführen?

Ein Agent soll bei einer Liste von Unternehmen den Sicherheitsverantwortlichen finden und mit jedem ein Gespräch beginnen. Der Agent findet die richtige Person in einem Tool-Aufruf, und die Plattform zahlt für die geöffneten Profile statt für die Suche.

Welche Forager-Produkte nutzt dieses Praxisbeispiel?

Personensuche und Personenanreicherung. Personensuche: Finden Sie die Personen, die bei Zielunternehmen eine Position innehaben, gefiltert nach Jobtitel, Seniorität, Abteilung und Standort. Personenanreicherung: ein vollständiges professionelles Profil zu einer Person anhand einer LinkedIn-URL, E-Mail-Adresse oder Telefonnummer: Berufserfahrung, Ausbildung, Skills und Kontaktkanäle.

Woher weiß ich, dass die Daten stimmen?

Der Test, der zählt, ist Ihr eigener: Senden Sie uns eine Liste von Profilen, die für Sie relevant sind. Wir führen ihn aus und zeigen Ihnen Zahl für Zahl, was wir finden, damit Sie Trefferquote und Erreichbarkeitsquote selbst messen können.

Wie finde ich mit einem Agent-Tool Entscheider?

Stellen Sie ein Tool find_people bereit, das die Anfrage des Agenten auf die Filter von POST /person_role_search/ abbildet: Jobtitel, Seniorität, Abteilung, Standort und Unternehmen. Prüfen Sie zuerst den Endpoint _totals, damit das Tool melden kann, wie viele Treffer es gibt, bevor es blättert.

Welche Tools können diesen Workflow ausführen?

Nativ in Clay, partnergebaut in Deepline und Cargo und per API aus Ihrem eigenen Code, Make und n8n aufrufbar. Oder rufen Sie die Endpoints der obigen Schritte mit einem API-Schlüssel aus Ihrem eigenen Code auf.

Wie viele Schritte hat dieser Workflow?

4 Schritte: Stellen Sie ein Tool find_people bereit, das die Anfrage des Agenten auf die Filter von POST /person_role_search/ abbildet: Jobtitel, Seniorität, Abteilung, Standort und Unternehmen; prüfen Sie zuerst den Endpoint _totals, damit das Tool melden kann, wie viele Treffer es gibt, bevor es blättert; geben Sie jeden Treffer als typisierten Datensatz mit person_id, Name, Jobtitel und Arbeitgeber zurück; und lassen Sie den Agenten POST /person_detail_lookup/ für die ein oder zwei ausgewählten Personen aufrufen, nicht für die gesamte Ergebnismenge.

Gibt es einen Vertrag oder eine Mindestabnahme?

Kein Vertrag zum Start: Ein kostenloses Konto enthält Credits im Wert von 5 $. Um Forager weiter zu nutzen, wählen Sie einen Monats- oder Jahrestarif. Monatstarife sind jederzeit kündbar und ungenutzte Credits werden übertragen; Jahrestarife gewähren alle Credits im Voraus und kosten 10 % weniger. Größere Volumen vereinbaren wir mit unserem Team.

Eine Auswahl von Teams, die diese Aufgabe mit Forager umsetzen · plus weitere Teams, die Forager nutzen

Clay
- GTM-Workflow-Builder
Ausgewählter Anwendungsfall: Forager-Mobilnummern, E-Mail-Adressen und Personendaten in Clay-Tabellen.
Juicebox
- KI-Kandidatensuche
Ausgewählter Anwendungsfall: Forager-Daten hinter der PeopleGPT-Suche und den Sourcing-Agenten.
Nooks
- Power- & Parallel-Dialer
Ausgewählter Anwendungsfall: Mobilnummern direkt im Dialer.
Emergent Labs
- Agent-Builder
KI-Plattform zum Bauen von Apps, auf der Agenten Full-Stack-Apps entwerfen, programmieren und bereitstellen.
Deepline
- Wasserfall-Anreicherung
Ausgewählter Anwendungsfall: Forager-Abfragen als typisierte Tools in Anreicherungs-Wasserfällen.

19 typisierte Forager-Tools in Deepline verfügbar¹
HubSpot
- CRM-Add-ons
Ausgewählter Anwendungsfall: Kontakt- und Unternehmensdatensätze mit Personen-, Unternehmens- und Stellenanzeigen-Daten anreichern.
BetterContact
- Wasserfall-Anreicherung
Ausgewählter Anwendungsfall: ein Forager-Schritt in dessen Wasserfall für Mobilnummern.
Salto
- Interne Nutzung
Plattform für kontrollierte Konfigurationsänderungen in allen Geschäftssystemen.

Quellen

¹ Deepline: deepline.com/integrations/forager (öffentliche Seite, abgerufen am 2026-10-21).

Verwandt

Personensuche als Agent-Tool anbieten

So fließen die Daten

Schritte

Eingaben und Ausgaben

Fragen zu diesem Praxisbeispiel

Wie kann mein Agent nach Personen mit einer bestimmten Position in einem Unternehmen suchen?

Was kostet es, Personensuche als Agent-Tool anzubieten?

Was brauche ich für dieses Praxisbeispiel und was kommt zurück?

Welche API für die Personensuche liefert typisierte Ergebnisse, die ein Agent nutzen kann?

Gibt es eine kostenlose Möglichkeit, Forager für diesen Workflow auszuprobieren?

Wann sollte ich diesen Workflow ausführen?

Welche Forager-Produkte nutzt dieses Praxisbeispiel?

Woher weiß ich, dass die Daten stimmen?

Wie finde ich mit einem Agent-Tool Entscheider?

Welche Tools können diesen Workflow ausführen?

Wie viele Schritte hat dieser Workflow?

Gibt es einen Vertrag oder eine Mindestabnahme?

Weitere Praxisbeispiele für Agent-Builder

Coding-Agenten typisierte Tools für Personen- und Unternehmensdaten geben

Personen- und Unternehmensdaten als integrierte Anbindung in einem KI-App-Builder anbieten

Forager als Wasserfall-Schritt im Kontakt-Tool eines Agenten

Die Account-Recherche eines Agenten mit Unternehmensanreicherung untermauern

CRM-Kontakte mit Jobwechsel erkennen und bei gewechselten Champions benachrichtigen

Eine Sales-Intelligence-Datenbank um eine zusätzliche Mobilnummern-Quelle ergänzen

Bringen Sie Personen-, Unternehmens- und Jobdaten, mit denen Ihre Nutzer arbeiten können, in Ihr Produkt