Eine E-Mail finden

Der E-Mail-Finder nimmt Vorname, Nachname und Firmen-Domain und gibt die geschäftliche E-Mail der Person zurück. Er funktioniert in der App (E-Mail-Finder in der Seitenleiste), in der REST-API, auf der Kommandozeile und in den MCP-Tools gleich.

Was es kostet

Du zahlst pro Abfrage, je nach Ergebnis, aus denselben Credits wie für alles andere.

Der Viertel-Credit kommt aus einem kleinen vorausbezahlten Guthaben. Die erste Abfrage ohne Treffer nimmt 1 Credit und hält 0,75 für die nächsten drei zurück. GET /api/v1/email-finder/pricing zeigt die Preise, dein Guthaben und deine Limits.

Behandle catch_all-Adressen als gute Vermutung. Schreib sie in kleineren Mengen an und behalte die Bounces im Blick.

Eine Person

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"}'

{ "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." }

Jeder Aufruf wird nach seinem eigenen Ergebnis berechnet. Wiederhol keine Abfrage, die nichts gefunden hat. Korrigier zuerst den Namen oder die Domain. Ein vollständiger Name geht auch: {"name": "Dr. Jane Doe", "domain": "acme.com"}.

Viele Personen

Schick bis zu 10.000 Personen als rows oder als CSV-Text, mit einem Ausgabelimit:

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"}]}'

Die Antwort enthält die job_id und maximum_charge, also das Maximum, das die Liste kosten kann. Prüf den Auftrag etwa alle 30 Sekunden mit GET /api/v1/email-finder/jobs/{job_id} und lies die Zeilen aus .../results, oder alle auf einmal mit .../results?format=csv.

Eine Liste pausiert, statt fehlzuschlagen:

Fortsetzen mit POST .../resume (optional {"max_credits": 150}) und stoppen mit POST .../cancel. Zeilen, die nie abgefragt wurden, werden nie berechnet.

Brauchbare CSV-Spalten sind first_name und last_name (oder name oder full_name), domain (oder company_domain oder website) und optional id oder ref, das mit dem Ergebnis zurückkommt.

Limits

30 Einzelabfragen pro Minute und 2.000 Abfragen pro Tag und Konto. Ein Konto, dessen Abfragen fast nie etwas finden, wird eine Zeit lang auf 20 pro Stunde gebremst. Es wird dabei nie mehr berechnet.

Aus dem Terminal

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

Aus einem KI-Assistenten

Der MCP-Server hat argorant_find_email für eine Person und argorant_find_emails für eine Liste (mit einem Ausgabelimit, das du setzen musst), dazu argorant_find_emails_status und argorant_manage_find_emails. Siehe Tools.