ArgorantDocs

Trouver un e-mail

Le nom d'une personne et le domaine de son entreprise en entrée, son e-mail professionnel en sortie. Une personne à la fois ou jusqu'à 10 000 personnes, depuis l'API, la ligne de commande, votre IA ou l'app.

La recherche d'e-mail prend un prénom, un nom et un domaine d'entreprise, et renvoie l'e-mail professionnel de la personne. Elle fonctionne de la même façon dans l'app (Trouver un e-mail dans la barre latérale), l'API REST, la ligne de commande et les outils MCP.

Ce que cela coûte

Vous payez par recherche, selon le résultat, avec les mêmes crédits que pour tout le reste.

RésultatstatusPrix
Trouvé et confirmévalid1 crédit
Le domaine de l'entreprise accepte toutes les adresses, donc aucune ne peut être confirmée. Vous obtenez la plus probable, marquée confirmed: falsecatch_all1 crédit
Rien trouvénot_found0,25 crédit
Saisie incorrecte, domaine sans messagerie, ou serveur de messagerie injoignable pour le moment400, no_mail_domain, retry_laterGratuit

Le quart de crédit est prélevé sur un petit solde prépayé. La première recherche sans résultat prend 1 crédit et en garde 0,75 pour les trois suivantes. GET /api/v1/email-finder/pricing affiche les prix, votre solde et vos limites.

Considérez les adresses catch_all comme une bonne hypothèse. Envoyez-leur des e-mails en plus petit nombre et surveillez les rebonds.

Une personne

Shell
curl -X POST "https://app.argorant.com/api/v1/email-finder/find" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: find-jane-doe-acme" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Jane", "last_name": "Doe", "domain": "acme.com"}'
JSON
{ "status": "valid", "email": "jane.doe@acme.com", "confirmed": true, "confidence": 95, "credits_charged": 1,
  "message": "Found and confirmed jane.doe@acme.com. 1 credit charged." }

Chaque appel est facturé selon son propre résultat. Ne répétez pas une recherche qui n'a rien trouvé ; corrigez d'abord le nom ou le domaine. Un nom complet fonctionne aussi : {"name": "Dr. Jane Doe", "domain": "acme.com"}.

Plusieurs personnes

Envoyez jusqu'à 10 000 personnes sous forme de rows ou de texte CSV, avec une limite de dépense :

Shell
curl -X POST "https://app.argorant.com/api/v1/email-finder/jobs" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: q4-accounts-finder" \
  -H "Content-Type: application/json" \
  -d '{"name": "Q4 accounts", "max_credits": 100, "rows": [{"first_name": "Jane", "last_name": "Doe", "domain": "acme.com", "ref": "crm-1042"}]}'

La réponse contient le job_id et maximum_charge, le coût maximal de la liste. Consultez la tâche environ toutes les 30 secondes avec GET /api/v1/email-finder/jobs/{job_id} et lisez les lignes depuis .../results, ou toutes d'un coup avec .../results?format=csv.

Une liste se met en pause au lieu d'échouer :

paused_reasonCe qui s'est passéQue faire
spend_limitElle a atteint votre max_creditsReprenez avec une limite plus élevée
insufficient_creditsLe compte n'a plus de créditsAjoutez des crédits, puis reprenez
daily_limitLa limite quotidienne de recherches est atteinteRien ; elle reprend après minuit UTC
miss_rateLa plupart des recherches n'ont rien trouvé, elle a donc ralentiRien ; elle continue. Vérifiez les noms et les domaines

Reprenez avec POST .../resume (éventuellement {"max_credits": 150}) et arrêtez avec POST .../cancel. Les lignes qui n'ont jamais été recherchées ne sont jamais facturées.

Les colonnes CSV acceptées sont first_name et last_name (ou name ou full_name), domain (ou company_domain ou website) et, en option, un id ou un ref qui revient avec le résultat.

Limites

30 recherches unitaires par minute et 2 000 recherches par jour et par compte. Un compte dont les recherches ne trouvent presque jamais rien est ralenti à 20 par heure pendant un certain temps. Il n'est jamais facturé davantage. Au-delà de ces limites, vous obtenez 429 avec finder_rate_limit, finder_daily_limit ou finder_miss_rate_throttle.

Un compte sans forfait et sans crédits issus d'un pack trouve jusqu'à 10 nouveaux e-mails par jour, comptés avec les déblocages et les exports. Au-delà, vous obtenez 429 daily_limit_reached.

Depuis le terminal

Shell
npx argorant find "Jane Doe" --domain acme.com
npx argorant find --file people.csv -o found.csv --max-credits 100
npx argorant find status <job_id>
npx argorant find pricing

Depuis un assistant IA

Le serveur MCP propose argorant_find_email pour une personne et argorant_find_emails pour une liste (avec une limite de dépense que vous devez fixer), ainsi que argorant_find_emails_status et argorant_manage_find_emails. Voir Outils.

Sur cette page