Die Suche beantwortet "Wer passt zu dieser Form?". Enrichment beantwortet eine andere Frage: "Ich habe diesen einen Datensatz schon, sag mir alles darüber." Das ist der Enrich-Endpunkt. Er nimmt jeweils eine Adresse, eine Person oder eine Firma, und er ist der Aufruf, den du in einen Formular-Handler, einen CRM-Abgleich oder einen Agenten einbaust, der gerade einen Namen bekommen hat.
POST https://app.argorant.com/api/v1/enrichAuthentifiziere dich mit einem API-Key von der Startseite als Bearer-Token, oder mit deiner angemeldeten Sitzung, wenn du ihn aus der App aufrufst.
Modus 1: aus einer E-Mail-Adresse eine Person
Schick nur eine Adresse, und du bekommst die Person dahinter: Name, Jobtitel, Seniorität, Abteilung, Firma, Firmendomain, Standort, Branche und Firmengröße.
curl -X POST https://app.argorant.com/api/v1/enrich \
-H "Authorization: Bearer $ARGORANT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "alex@evenito.com"}'{
"found": true,
"type": "person",
"person_id": "p_8d4ba3d46cc885007c38e437",
"person": {
"full_name": "Alex Schneider",
"title": "VP of Sales",
"seniority": "VP",
"departments": ["Sales"],
"email": "alex@evenito.com",
"current_company_name": "Evenito",
"current_company_domain": "evenito.com",
"country": "Switzerland"
},
"charged": 1,
"already_revealed": false,
"deliverable": true,
"verification": "valid"
}Modus 2: aus Name plus Firmendomain eine verifizierte E-Mail
Du weißt, wen du willst und wo die Person arbeitet, aber nicht, wie du sie erreichst. Schick beides, und Argorant findet den Datensatz und schaltet die geschäftliche E-Mail frei, verifiziert in diesem Moment.
curl -X POST https://app.argorant.com/api/v1/enrich \
-H "Authorization: Bearer $ARGORANT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "Alex Schneider", "domain": "evenito.com"}'Ein Name ohne Domain reicht nicht, denn Namen sind nicht eindeutig. Kombiniere beides, oder nutze Modus 1.
Modus 3: aus einer Domain ein Firmenprofil
Schick nur eine Domain, und du bekommst die Firma: Name, Domain, Branche und Standort. Keine Kontaktdaten und keine Credits.
curl -X POST https://app.argorant.com/api/v1/enrich \
-H "Authorization: Bearer $ARGORANT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domain": "evenito.com"}'{
"found": true,
"type": "company",
"charged": 0,
"company": {
"company": "Evenito",
"company_domain": "evenito.com",
"industry": "Software Development",
"country": "Switzerland"
}
}Was es kostet
Jede Antwort enthält ein Feld charged, die Rechnung ist also nie geraten. Es gelten unverändert die Regeln für das Freischalten:
- Ein Personentreffer kostet 1 Credit. Modus 1 und 2 werden genau so berechnet wie das Freischalten dieses Kontakts überall sonst in Argorant.
- Du zahlst einmal pro Kontakt, für immer. Dieselbe Person erneut anzureichern liefert dasselbe Profil mit
charged: 0undalready_revealed: true, egal ob der zweite Aufruf über die API, die CLI, einen Agenten oder die App kommt. - Kein Treffer ist kostenlos. Ohne Treffer kommt
{"found": false, "type": "person", "charged": 0}zurück und kostet nichts. - Eine nicht zustellbare Adresse ist kostenlos. Die E-Mail wird im Moment der Anreicherung live geprüft. Besteht sie nicht, wird die Adresse zurückgehalten und nichts berechnet.
- Firmen-Enrichment ist kostenlos. Modus 3 verbraucht null Kontakt-Credits, wie Zählungen und Vorschauen.
Im Fall einer nicht zustellbaren Adresse kommt der Grund mit, ein Agent kann ihn also protokollieren, statt es erneut zu versuchen:
This email didn't pass live verification, so it wasn't charged - you only pay for deliverable contacts.
Diese Antwort hat trotzdem found: true, aber deliverable: false und charged: 0, und die E-Mail-Felder sind leer. Verzweige auf deliverable, nicht auf found, wenn du eine Adresse brauchst, an die du schreiben kannst.
Wenn es nicht funktioniert
Jeder Fehler ist ein einfacher Statuscode mit einer Meldung, mit der du etwas anfangen kannst.
400: Es wurde nichts Brauchbares gesendet
Pass {email}, {name+domain}, or {domain} for a company.
Der Body war leer, oder er enthielt einen Namen ohne Domain. Schick eine der drei Formen.
401: Der Key wurde nicht akzeptiert
Not authenticated
Der Key fehlt, ist vertippt oder widerrufen. Erstelle einen neuen auf der Startseite und denk daran, dass ein Key nur einmal bei der Erstellung angezeigt wird.
402: nicht genug Credits
Revealing an email costs 1 credit, and you don't have enough. Add credits or upgrade.
Das kann nur in den Personenmodi passieren. Lade auf der Startseite auf oder sieh unter Profil, dann Abrechnung nach. Firmen-Enrichment funktioniert auch mit leerem Guthaben weiter.
403: Der Key darf keine Kontakte freischalten
This Argorant connector is not allowed to use that action
Personen-Enrichment braucht den Scope zum Freischalten von Kontakten, weil es Kontaktdaten herausgibt. Firmen-Enrichment nicht. Ein bewusst nur lesender Key schafft Modus 3 und verweigert Modus 1 und 2, und genau so ist es gedacht.
429: zu schnell
You're moving faster than expected. The limit resets automatically, so try again shortly.
Verteil die Aufrufe zeitlich. Enrichment ist ein Aufruf pro Datensatz, eine große Liste ist mit einem Export besser bedient als mit einer Schleife.
Über die CLI und über einen Agenten
Dieselben drei Modi gibt es in der CLI, und kein Treffer endet mit Code 1, ein Skript kann also verzweigen, ohne die Antwort zu lesen:
npx argorant enrich --email alex@evenito.com --json
npx argorant enrich --name "Alex Schneider" --domain evenito.com
npx argorant enrich --domain evenito.comÜber MCP verbundene Agenten bekommen dasselbe als Tool argorant_enrich, mit den Abrechnungsregeln in der Tool-Beschreibung. Der Agent weiß also, dass eine Firmenabfrage kostenlos ist, bevor er fragt.
Ein letzter Gedanke, der Credits spart: Enrichment ist für Datensätze, die du schon hast. Wenn du Leute finden willst, die zu einer Form passen, zähl und sieh dir die Vorschau zuerst an, und exportiere dann. Enrichment in einer Schleife über eine Liste, die du hättest exportieren können, kostet pro Kontakt dasselbe, dauert aber viel länger.