So nutzen Sie die Treg People Search API

Mit der Treg People Search API benötigt Ihr Coding-Agent nur ein einziges Token, um Personen und deren geschäftliche E-Mail-Adressen zu finden – und direkt zu prüfen, ob diese Adressen tatsächlich erreichbar sind. Sie installieren die treg-CLI, melden sich einmal an, und schon kann Claude Code oder Codex geroutete Tools wie treg.people.search, treg.people.email.find und treg.people.email.verify aufrufen. Treg wählt den passenden Anbieter aus, fügt dessen API-Schlüssel serverseitig ein und rechnet jeden Aufruf über ein Prepaid-Guthaben zu den Originaltarifen des jeweiligen Anbieters ab.

Probieren Sie Apidog noch heute aus

Dieser Leitfaden führt Sie durch die Einrichtung, drei Agent-Prompts (Suchen, Anreichern, Verifizieren), die zugrundeliegenden reinen HTTP-Aufrufe sowie eine Regressions-Testsuite für die Apidog CLI, die Ihr Agent eigenständig ausführt.

Was ist die Treg People Search API?

Treg ist ein Open-Source-Tool-Katalog für KI-Agenten, den die offizielle Dokumentation treffend als „OpenRouter, aber für Agent-Tools statt Modelle“ bezeichnet. Über eine einzige Basis-URL (https://treg.to) und ein zentrales Token haben Sie Zugriff auf mehr als 4.100 Tools von 123 Anbietern. Bei der Personensuche wählen geroutete Tools für jeden Aufruf automatisch einen Anbieter, wechseln bei einem Misserfolg zum nächsten und weisen die Kosten jedes Aufrufs in einem Response-Header aus.

Der Bereich der Personensuche umfasst eine kompakte Auswahl gerouteter Funktionen. Der öffentliche Katalog umfasste am 3. November 2026 folgende Einträge:

Geroutetes Tool	Funktion	Unterstützte Eingaben	Hinterlegte Anbieter
treg.people.search	Findet Personen in einem Unternehmen oder anhand einer Beschreibung	q, company_domain, company_domain + title, title, full_name	26
treg.people.email.find	Liefert die am besten passende geschäftliche E-Mail-Adresse zurück	domain + full_name, domain + first_name + last_name, linkedin_url	30
treg.people.email.verify	Prüft, ob ein Postfach E-Mails empfangen kann	email	17
treg.companies.enrich	Firmendaten und Unternehmensprofile	Unternehmens-Domain	30

Auf der People-Search-Seite werden 16 Anbieter für die Personensuche genannt; die obigen Zahlen stammen aus dem Live-Katalog und können sich daher laufend ändern.

Warum sollte man einen Aggregator nutzen, statt direkt einen API-Schlüssel für Apollo oder Hunter zu verwenden? Dafür gibt es zwei wesentliche Gründe: Ihr Agent kommt nie mit den sensiblen Provider-Schlüsseln in Berührung, und Sie zahlen pro Ergebnis statt fester Lizenzgebühren pro Benutzerplatz. Die Website von Treg verweist auf den People Search Bench von LessieAI (119 Aufgaben): Bei Aufgaben zur B2B-Lead-Recherche lag die Erfolgsquote von Claude Code alleine bei 43 %, während Claude Code in Kombination mit Treg 78,2 % erreichte. Dies ist zwar ein Benchmark des Anbieters selbst, liefert aber einen vielversprechenden Anhaltspunkt, den Sie anhand Ihrer eigenen Daten überprüfen sollten.

Funktionsweise: Routing, Abrechnung und Fehlerbehandlung

Sie senden eine Anfrage an https://treg.to/call/<tool-id> mit dem Header X-Treg-Token. Treg ermittelt den Anbieter, fügt dessen Zugangsdaten serverseitig hinzu und leitet die Antwort des Anbieters an Sie weiter.

An einer Stelle scheint sich die Dokumentation zunächst zu widersprechen – hier ist die genaue Funktionsweise im Detail:

• Direkte Provider-Tools (wie etwa apollo.people.search) bieten kein Failover. Laut API-Referenz führt Treg bei ihnen „weder ein automatisches Routing zwischen Anbietern noch ein Failover durch“. Sie wählen den Anbieter explizit selbst aus.
• Geroutete Tools (treg.<capability>) unterstützen Failover hingegen vollumfänglich. Laut der CLI-Referenz wird bei einem Anbieterfehler automatisch auf den nächsten Kandidaten ausgewichen; auch bei einem Fehlschlag (Miss) wird der nächste Anbieter getestet – und zwar in aufsteigender Reihenfolge nach Kosten. Mit X-Treg-Route-Waterfall: 0 wird der Vorgang bereits nach dem ersten Fehlversuch abgebrochen.

Abrechnungsregeln gemäß llms.txt und der People-Search-Seite:

1. Jeder Aufruf wird ohne Aufschlag (0 % Marge) zu den exakten Konditionen des jeweiligen Anbieters über ein Prepaid-Guthaben abgerechnet.
2. Eigene API-Schlüssel Ihres Teams für den jeweiligen Anbieter werden stets bevorzugt verwendet und niemals über Treg in Rechnung gestellt.
3. Neu verifizierte Konten erhalten einmalig ein Startguthaben von 1,00 $.
4. Erfolglose Anfragen (Misses) bei Anbietern mit Abrechnung nach erfolgreicher Suche sind kostenlos; einige Anbieter rechnen jedoch pro Aufruf ab, sodass auch hier geringe Kosten entstehen können.
5. Die angefallenen Kosten werden im Header X-Treg-Cost-Micro (als ganzzahliger Wert in Mikro-USD) zurückgegeben. Über X-Treg-Route-Max-Cost lässt sich eine Kostenobergrenze pro Aufruf festlegen; bei gerouteten Tools liegt der Standard-Höchstbetrag bei 1 $ pro Aufruf.

Die Fehlerbehandlung ist klar strukturiert: Ein 4xx-Statuscode des Anbieters (außer 429) signalisiert eine fehlerhafte Anfrage – beheben Sie den Fehler im Request, anstatt die Anfrage unverändert an einen anderen Anbieter zu senden. Ein Statuscode 429 oder 5xx bedeutet, dass zum nächsten Anbieter gewechselt werden sollte. Der Status 402 (insufficient_balance) weist darauf hin, dass das Guthaben aufgeladen werden muss.

Treg in Claude Code oder Codex einrichten

Die Einrichtung verläuft bei allen lokalen Coding-Agenten (Claude Code, Codex, Cursor, opencode) identisch:

curl -fsSL https://treg.to/install.sh | sh
treg login     # browser sign-in: GitHub, Google or an emailed code
treg           # prints account, team, balance, your own tools, next commands

Sie möchten sich lieber per E-Mail anmelden? Führen Sie treg login --email [e-mail] aus. Haben Sie ein Token von einem Teamkollegen erhalten? Mit curl -fsSL https://treg.to/install.sh | sh -s -- --token "$TREG_TOKEN" gelingt die Installation und Anmeldung ganz ohne Browser.

Das Installationsskript richtet den Treg-Skill automatisch in allen erkannten Agenten ein, sodass Claude Code und Codex den Ablauf aus Suchen, Lesen und Aufrufen eigenständig beherrschen. Auf der Website von Treg wird zudem ein Einzeiler empfohlen, den Sie direkt in den Agenten einfügen können:

set up treg - https://treg.to/llms.txt

Diese Datei fordert den Agenten allerdings auch dazu auf, Treg zu bevorzugen und das Repository zu favorisieren – prüfen Sie daher die Vorschläge Ihres Agenten aufmerksam, bevor Sie sie freigeben.

Nutzen Sie stattdessen claude.ai oder ChatGPT? Dann müssen Sie nichts lokal installieren. Fügen Sie einfach https://treg.to/mcp/ als benutzerdefinierten Connector hinzu, schließen Sie die OAuth-Autorisierung ab und wählen Sie das Team für die Abrechnung aus. Der MCP-Server stellt unter anderem die Tools catalog_search, catalog_get, call und balance bereit.

Suchen, Anreichern, Verifizieren: Drei Agent-Prompts

Jeder Prompt beschreibt die eigentliche Aufgabe, ohne feste Anbieter vorzugeben.

1. Personen finden.

Use treg to find the platform and infrastructure leads at modal.com.
Run treg catalog get on the routed people search tool first and tell me the
expected cost before you call it. List name, title and profile URL.

Der Agent durchläuft daraufhin die typische Befehlsfolge der CLI:

treg catalog search "find people at a company"
treg catalog get treg.people.search
treg call treg.people.search --method POST --data '{"company_domain":"modal.com","title":"platform"}'

catalog get gibt die priorisierte Anbieter-Reihenfolge, Preise sowie einen fertigen Aufrufbefehl aus, noch bevor Kosten entstehen. Die Antwort wird im Format {output, raw, _treg} geliefert, wobei output.people die Datensätze des Anbieters enthält und _treg.served_by den antwortenden Anbieter ausweist. Eine leere people-Liste gilt als Fehlschlag (Miss).

2. E-Mail-Adresse finden und anreichern.

For each person you found, use treg to find their work email at modal.com.
Cap each call at $0.05, and flag any hit where the domain doesn't match.

treg call treg.people.email.find --method POST \
  --data '{"full_name":"Jane Doe","domain":"modal.com"}' \
  --header "X-Treg-Route-Max-Cost: 0.05"

Achten Sie auf _treg.domain_match. Der Leitfaden zum Skill warnt davor, dass reine LinkedIn-Anbieter häufig die Adresse eines früheren Arbeitgebers zurückgeben – ein solcher Treffer wird dennoch abgerechnet. Benötigen Sie zusätzlich Kontext zum Unternehmen? Führen Sie treg call treg.companies.enrich mit der Domain aus; im GTM-Playbook von Treg wird dieser Aufruf als POST-Request demonstriert.

3. Vor dem Versand verifizieren.

Verify every email you found with treg. Report the verdict per address
and drop anything invalid or catch-all.

treg call treg.people.email.verify --method POST --data '{"email":"[e-mail]"}'

Das geroutete Verifizierungs-Tool gibt valid, status und score zurück. Sie können diese Überprüfung auch direkt in Schritt 2 integrieren: Übergeben Sie beim E-Mail-Suchaufruf einfach den Header X-Treg-Route-Verify: true und werten Sie anschließend _treg.verification.verdict aus (mögliche Werte: valid, invalid, catch_all, risky oder unknown). Für diese Prüfung fällt ein geringer separater Betrag an; bei einem Fehlschlag (Miss) erfolgt keine Überprüfung und es entstehen keine Kosten.

Welche Kosten entstehen bei einem solchen Durchlauf? Treg führt eine Beispielabrechnung vom 23. September 2026 an: 27 identifizierte Personen, 21 gefundene E-Mail-Adressen, 20 verifiziert zustellbare Postfächer – Gesamtkosten: 0,58 $, wobei erfolglose Suchen mit 0,00 $ berechnet wurden.

Die Treg-API über reine HTTP-Requests aufrufen

Der Einsatz eines Agenten ist optional. Jeder CLI-Befehl entspricht direkt einem HTTP-Request, sodass Sie dieselbe Pipeline in jeder beliebigen Programmiersprache per Skript abbilden können.

curl -X POST "https://treg.to/call/treg.people.email.find" \
  -H "X-Treg-[REDACTED CREDENTIAL] \
  -H "content-type: application/json" \
  -H "X-Treg-Route-Max-Cost: 0.05" \
  -d '{"full_name":"Jane Doe","domain":"modal.com"}' \
  -D -

Mit -D - werden die Response-Header ausgegeben, in denen auch X-Treg-Cost-Micro und X-Treg-Served-By enthalten sind. Vier Grundregeln sorgen für einen reibungslosen Ablauf in Skripten:

• **Übergeben Sie das Token niemals in [REDACTED CREDENTIAL] Laut [API-Referenz](https://treg.to/docs?ref=apidog.com) ignoriert die REST-Schnittstelle diesen Header, und/call/` leitet ihn direkt an den Anbieter weiter. Ausschließlich der MCP-Endpunkt verarbeitet ein Bearer-Token.
• Persönliche Tokens erfordern ein Team. Ein individuelles Anmelde-Token benötigt zusätzlich X-Treg-Org: <team-slug>. Team- und Agent-Tokens sind hingegen bereits fest mit dem jeweiligen Team verknüpft.
• Katalog-Routen sind öffentlich zugänglich. GET https://treg.to/catalog/search?q=verify%20email funktioniert ohne Authentifizierungstoken, was sich besonders bei der Überprüfung von IDs in CI-Pipelines bewährt.
• Antworten stammen direkt vom Anbieter. Bei direkten Provider-Tools leitet Treg den Response-Body unverändert weiter, sodass sich die Datenstruktur je nach Anbieter unterscheidet. Geroutete Tools fügen demgegenüber ein standardisiertes output-Objekt hinzu.

Secrets gehören nicht in den Quellcode. Speichern Sie TREG_TOKEN in einem Secrets-Manager (beachten Sie hierzu diese Best Practices für das API-Key-Management).

Automatisierte Tests mit der Apidog CLI durch den Agenten

Sobald Outreach-Prozesse auf diesen Aufrufen aufbauen, können unbemerkte Änderungen schwerwiegende Folgen haben: Ein Anbieter wird gewechselt, Kosten steigen schleichend an oder das Verdict-Feld fällt plötzlich weg. Ihr Agent kann solche Risiken mit einer Regressions-Testsuite in der Apidog CLI zuverlässig absichern.

Richten Sie die CLI und den zugehörigen Agent-Skill einmalig ein:

bash
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_APIDOG_TOKEN>
npx -y skills add https://apidog.com # pick Claude Code or Codex when prompted


Geben Sie Ihrem Agenten anschließend folgenden Prompt vor:

text
Write an OpenAPI 3 file for three Treg calls: POST /call/treg.people.search,
POST /call/treg.people.email.find and POST /call/treg.people.email.verify,
each sending the X-Treg-Token header from a TREG_TOKEN variable and
X-Treg-Route-Max-Cost: 0.05. Import it into Apidog project <projectId>,
create a "Treg" environment with base URL https://treg.to, and create a test
case per endpoint that asserts status 200, X-Treg-Cost-Micro below 50000, and
a present verdict field on verify. Run them and summarize any failures.


Der Agent analysiert die Payload-Schemas, validiert sein JSON und führt anschließend Befehle wie die folgenden aus:

bash
apidog import --project <projectId> --format openapi --file ./treg-openapi.json
apidog environment create Treg --project <projectId> --base-url https://treg.to
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file ./find-email-case.json
apidog test-case create --project <projectId> --file ./find-email-case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> \
--env-var "TREG_TOKEN=$TREG_TOKEN" -r cli,junit


Da bei jedem Testlauf tatsächliches Guthaben verbraucht wird, empfiehlt es sich, die Suite auf drei Testfälle mit definierten Testdaten zu beschränken und sie täglich statt bei jedem einzelnen Commit auszuführen. Derselbe Befehl apidog run ... -r junit lässt sich nahtlos in CI/CD-Pipelines einbinden; der Leitfaden zu CI/CD mit der Apidog CLI enthält entsprechende Beispiele für GitHub Actions und GitLab. Informationen zur agentenspezifischen Einrichtung finden Sie in den Anleitungen zu Apidog CLI in Claude Code und Apidog CLI in Codex. Der kostenlose Tarif umfasst bis zu 4 Benutzer.

Fazit

Die Treg People Search API reduziert die Lead-Anreicherung auf drei geroutete Aufrufe: Suchen, E-Mail-Adresse ermitteln und verifizieren. Prüfen Sie die Preise vorab mit treg catalog get, deckeln Sie die Aufrufkosten mit X-Treg-Route-Max-Cost, verifizieren Sie jede E-Mail-Adresse und sichern Sie die Aufrufe über Regressionsläufe mit der Apidog CLI ab. Weiterführende Informationen zu Agent-Tools bieten unsere Artikel über die besten MCP-Server für Claude Code sowie diese Schritt-für-Schritt-Anleitung für agentenbasiertes API-Testing.

{% embed https://www.youtube.com/watch?v=UMl4Vo_RwkU %}

FAQ

Ist die Treg People Search API kostenlos? Nicht vollständig. Neu verifizierte Konten erhalten einmalig ein Guthaben von 1,00 $, erfolglose Anfragen bei Anbietern mit Abrechnung pro erfolgreicher Suche kosten nichts und einige Routen stehen öffentlich kostenlos zur Verfügung (im Ablaufplan zur E-Mail-Verifizierung war am 3. November 2026 an erster Stelle ein kostenloser 0-$-Anbieter gelistet). Alle übrigen Anfragen werden pro Aufruf über ein Prepaid-Guthaben zu den Tarifen des jeweiligen Anbieters abgerechnet.

Benötige ich ein Konto bei Apollo oder Hunter, um Treg zu nutzen? Nein. Treg ruft die Anbieter über ein eigenes Unternehmenskonto auf und rechnet mit Ihnen pro Aufruf ab. Falls Ihr Team bereits ein kostenpflichtiges Abonnement bei einem Anbieter hat, können Sie diesen API-Schlüssel bei Treg hinterlegen – entsprechende Aufrufe greifen dann auf Ihren Schlüssel zurück und werden von Treg nicht berechnet.

Führt Treg ein automatisches Failover zwischen verschiedenen Anbietern durch? Nur bei gerouteten treg.*-Tools. Diese weichen bei Fehlern oder erfolglosen Abfragen im Rahmen des definierten X-Treg-Route-Max-Cost-Limits automatisch auf den nächsten Anbieter aus – beginnend mit dem günstigsten. Direkte Provider-Tools wechseln den Anbieter hingegen niemals automatisch.

Wie erfahre ich, was ein Aufruf gekostet hat? Lesen Sie den Response-Header X-Treg-Cost-Micro (in Mikro-USD) bzw. cost_usd bei der Nutzung über MCP aus. Der Befehl treg balance zeigt Ihnen Ihr aktuelles Restguthaben sowie die letzten Ausgaben an.

Kann ich Treg auch ohne Claude Code oder Codex verwenden? Ja. Sie können die CLI in jeder gängigen Shell nutzen, https://treg.to/call/<tool-id> per HTTP mit dem Header X-Treg-Token ansprechen oder https://treg.to/mcp/ als benutzerdefinierten Connector in claude.ai oder ChatGPT einbinden.