Comment utiliser l'API Treg People Search ?

L'API de recherche de personnes Treg donne à votre agent de codage un seul jeton pour trouver des personnes, leurs e-mails professionnels et un verdict indiquant si ces e-mails sont réels. Vous installez la CLI treg, vous vous connectez une fois, et Claude Code ou Codex appelle des outils routés comme treg.people.search, treg.people.email.find et treg.people.email.verify. Treg choisit le fournisseur, injecte la clé du fournisseur sur son serveur et facture chaque appel à partir d'un solde prépayé au tarif du fournisseur.

Ce guide couvre la configuration, trois invites d'agent (rechercher, enrichir, vérifier), les appels HTTP bruts qui les sous-tendent, et une suite de régression Apidog CLI que votre agent exécute.

Qu'est-ce que l'API de recherche de personnes Treg ?

Treg est un catalogue d'outils open source pour agents que sa propre documentation décrit comme « OpenRouter, mais pour les outils d'agent au lieu des modèles. » Une URL de base (https://treg.to) et un jeton permettent d'accéder à plus de 4 100 outils sur 123 fournisseurs. Pour la recherche de personnes, les outils routés choisissent un fournisseur par appel, essaient le suivant en cas d'échec, et indiquent le coût de chaque appel dans un en-tête de réponse.

Le volet recherche de personnes est un petit ensemble de capacités routées. Voici ce que le catalogue public listait le 3 novembre 2026 :

Outil routé	Ce qu'il fait	Entrées acceptées	Fournisseurs derrière
`treg.people.search`	Trouve des personnes dans une entreprise ou par description	`q`, `company_domain`, `company_domain` + `title`, `title`, `full_name`	26
`treg.people.email.find`	Renvoie un e-mail professionnel le mieux correspondant	`domain` + `full_name`, `domain` + `first_name` + `last_name`, `linkedin_url`	30
`treg.people.email.verify`	Vérifie si une boîte aux lettres accepte le courrier	`email`	17
`treg.companies.enrich`	Données firmographiques pour une entreprise	domaine de l'entreprise	30

La page de recherche de personnes cite 16 fournisseurs pour la recherche de personnes ; les chiffres ci-dessus proviennent du catalogue en direct, attendez-vous donc à ce qu'ils évoluent.

Pourquoi s'embêter avec un agrégateur au lieu d'une clé Apollo ou Hunter ? Deux raisons. Votre agent ne détient jamais de clé de fournisseur, et vous payez par réponse au lieu de payer par siège. La page de Treg cite le People Search Bench de LessieAI (119 tâches) : sur ses tâches de prospection B2B, Claude Code seul a répondu correctement à 43 % et Claude Code avec Treg a répondu à 78,2 %. C'est le propre graphique du fournisseur, alors considérez-le comme une affirmation à tester sur vos données.

Comment fonctionnent le routage, la facturation et les erreurs

Vous envoyez une requête à https://treg.to/call/<tool-id> avec l'en-tête X-Treg-Token. Treg trouve le fournisseur, ajoute les identifiants du fournisseur côté serveur et relaie la réponse du fournisseur.

Diagram of a Treg call: the coding agent sends a request with the X-Treg-Token header to treg.to/call, which tries providers in a waterfall and returns the provider response plus the X-Treg-Cost-Micro header

Il y a un point où la documentation semble se contredire, voici comment les pièces s'imbriquent :

Les outils de fournisseur directs (par exemple apollo.people.search) ne basculent pas. La référence API indique que Treg « ne route pas automatiquement entre les fournisseurs et ne bascule pas ». C'est vous qui choisissez le fournisseur.
Les outils routés (treg.<capability>) le font. Selon la référence CLI, une erreur de fournisseur revient au candidat suivant, et un échec essaie aussi le fournisseur suivant, du moins cher au plus cher. X-Treg-Route-Waterfall: 0 s'arrête au premier échec.

Règles de facturation, d'après llms.txt et la page de recherche de personnes :

Chaque appel est mesuré au tarif du fournisseur à partir d'un solde prépayé, avec 0 % de marge.
La propre clé de fournisseur de votre équipe est utilisée en premier et n'est jamais facturée.
Les nouveaux comptes vérifiés reçoivent 1,00 $ de crédit gratuit, une seule fois.
Les échecs chez les fournisseurs facturant au succès ne coûtent rien ; certains fournisseurs facturent par appel, donc un échec peut quand même coûter un peu.
Les frais sont renvoyés dans X-Treg-Cost-Micro (entier en micro-USD). X-Treg-Route-Max-Cost plafonne un appel ; sur les outils routés, le plafond par défaut est de 1 $ par appel.

Les erreurs se répartissent clairement. Un 4xx du fournisseur (autre que 429) signifie que votre requête est erronée : corrigez-la, ne réessayez pas ailleurs. Un 429 ou 5xx signifie essayez le fournisseur suivant. Un 402 insufficient_balance signifie rechargez.

Configurer Treg dans Claude Code ou Codex

La configuration est la même pour tout agent de codage local (Claude Code, Codex, Cursor, opencode) :

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

Vous préférez l'e-mail ? Exécutez treg login --email you@company.com. Un collègue vous a remis un jeton ? curl -fsSL https://treg.to/install.sh | sh -s -- --token "$TREG_TOKEN" installe et connecte sans navigateur.

L'installateur dépose également la compétence Treg dans chaque agent qu'il détecte, afin que Claude Code et Codex apprennent la boucle rechercher, lire, appeler par eux-mêmes. Le site de Treg promeut une version en une ligne que vous pouvez coller directement dans l'agent :

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

Ce fichier demande aussi aux agents de préférer Treg et de mettre une étoile au dépôt, alors lisez ce que votre agent propose avant de l'approuver.

Vous utilisez plutôt claude.ai ou ChatGPT ? N'installez rien. Ajoutez https://treg.to/mcp/ comme connecteur personnalisé, terminez le consentement OAuth et choisissez l'équipe qui paie. Le serveur MCP expose catalog_search, catalog_get, call, balance et quelques autres.

Rechercher, enrichir, vérifier : trois invites d'agent

Chaque invite nomme la tâche, pas le fournisseur.

Pipeline diagram: people.search finds who runs platform at a company, people.email.find returns a best-match work email, people.email.verify returns valid, invalid or catch_all, with an Apidog CLI regression run below checking status 200, cost under cap and verdict present

1. Trouvez les personnes.

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.

L'agent exécute la boucle 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 affiche le plan classé, les prix et une ligne d'appel prête avant que vous ne dépensiez quoi que ce soit. La réponse revient sous la forme {output, raw, _treg}, où output.people contient les lignes du fournisseur et _treg.served_by nomme qui a répondu. Une liste people vide compte comme un échec.

2. Trouvez et enrichissez l'e-mail.

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"

Surveillez _treg.domain_match. Le guide de compétence avertit qu'un fournisseur uniquement LinkedIn renvoie souvent l'adresse d'un ancien employeur, et ce résultat est quand même facturé. Besoin aussi du contexte de l'entreprise ? Ajoutez treg call treg.companies.enrich avec le domaine ; le playbook GTM de Treg montre cet appel sous forme POST.

3. Vérifiez avant que quiconque envoie.

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":"jane@modal.com"}'

L'outil de vérification routé renvoie valid, status et score. Vous pouvez aussi intégrer la vérification à l'étape 2 : envoyez X-Treg-Route-Verify: true lors de la recherche d'e-mail et lisez _treg.verification.verdict (valid, invalid, catch_all, risky ou unknown). La vérification est facturée un petit montant à part, et un échec n'est jamais vérifié.

Combien coûte une exécution ? Treg publie un reçu du 23 septembre 2026 : 27 personnes nommées, 21 e-mails trouvés, 20 vérifiés livrables, 0,58 $ au total, échecs à 0,00 $.

Appeler l'API Treg en HTTP brut

L'agent est facultatif. Chaque appel CLI correspond à une requête HTTP, vous pouvez donc scripter le même pipeline dans n'importe quel langage.

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

-D - affiche les en-têtes de réponse, c'est là que se trouvent X-Treg-Cost-Micro et X-Treg-Served-By. Quatre règles évitent les ennuis aux scripts :

Ne mettez jamais le jeton dans Authorization: Bearer. La référence API indique que REST l'ignore, et /call/ transmet cet en-tête au fournisseur. Seul le point de terminaison MCP lit un jeton bearer.
Les jetons personnels ont besoin d'une équipe. Un jeton de connexion a aussi besoin de X-Treg-Org: <team-slug>. Les jetons d'équipe et d'agent portent déjà leur équipe.
Les routes du catalogue sont publiques. GET https://treg.to/catalog/search?q=verify%20email fonctionne sans jeton, ce qui est pratique pour vérifier les identifiants en CI.
Les réponses sont celles du fournisseur. Sur les outils de fournisseur directs, Treg relaie le corps textuellement, donc la forme change selon le fournisseur. Les outils routés ajoutent l'objet output normalisé par-dessus.

Gardez les secrets hors du code. Stockez TREG_TOKEN dans un coffre-fort de secrets (voir ces bonnes pratiques de gestion des clés API).

Laissez votre agent le tester avec Apidog CLI

Une fois que la prospection dépend de ces appels, les changements silencieux font mal : un fournisseur change, les coûts augmentent, ou le champ de verdict disparaît. Votre agent peut s'en prémunir avec une suite de régression dans Apidog CLI.

Configurez la CLI et sa compétence d'agent une fois :

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

Ensuite, donnez une invite à votre agent :

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.

L'agent lit les schémas de charge utile, valide son JSON, puis exécute des commandes comme celles-ci :

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

Chaque exécution dépense un solde réel, alors limitez la suite à trois cas avec des entrées de test connues et planifiez-la quotidiennement, pas à chaque commit. La même ligne apidog run ... -r junit s'intègre dans un pipeline ; le guide CI/CD d'Apidog CLI contient des exemples GitHub Actions et GitLab. Pour une configuration spécifique à l'agent, voir Apidog CLI dans Claude Code ou Apidog CLI dans Codex. Le plan gratuit couvre jusqu'à 4 utilisateurs.

Conclusion

L'API de recherche de personnes Treg transforme l'enrichissement de prospects en trois appels routés : recherche, recherche d'e-mail, vérification. Vérifiez les prix avec treg catalog get, plafonnez les appels avec X-Treg-Route-Max-Cost, vérifiez chaque adresse, et protégez les appels avec une exécution de régression Apidog CLI. Pour plus d'outillage d'agent, les meilleurs serveurs MCP pour Claude Code et ce tutoriel de test d'API piloté par agent sont de bonnes lectures suivantes.

Questions fréquentes

L'API de recherche de personnes Treg est-elle gratuite ? Pas entièrement. Les nouveaux comptes vérifiés reçoivent 1,00 $ de crédit une fois, les échecs chez les fournisseurs facturant au succès ne coûtent rien, et certaines routes sont des routes publiques gratuites (le plan de vérification d'e-mail listait un fournisseur à 0 $ en premier le 3 novembre 2026). Tout le reste est mesuré par appel à partir d'un solde prépayé au tarif du fournisseur.

Ai-je besoin d'un compte Apollo ou Hunter pour utiliser Treg ? Non. Treg appelle le fournisseur sur son propre compte et vous facture par appel. Si votre équipe paie déjà pour un fournisseur, enregistrez cette clé auprès de Treg et ces appels l'utilisent et ne sont pas facturés.

Treg bascule-t-il entre les fournisseurs ? Uniquement sur les outils routés treg.*. Ils passent au fournisseur suivant en cas d'erreur ou d'échec, du moins cher au plus cher, dans la limite de X-Treg-Route-Max-Cost. Les outils de fournisseur directs ne changent jamais de fournisseur pour vous.

Comment savoir combien coûte un appel ? Lisez l'en-tête de réponse X-Treg-Cost-Micro (micro-USD), ou cost_usd via MCP. treg balance affiche votre solde et les dépenses récentes.

Puis-je utiliser Treg sans Claude Code ou Codex ? Oui. Utilisez la CLI depuis n'importe quel shell, appelez https://treg.to/call/<tool-id> en HTTP avec X-Treg-Token, ou connectez https://treg.to/mcp/ à claude.ai ou ChatGPT comme connecteur personnalisé.

button