ArgorantDocs

Meine Liste prüfen

Prüf die E-Mails auf einer Liste, die du schon hast, bevor du sie anschreibst. Hol ein kostenloses Angebot, sag Ja und sieh, welche Adressen gut sind. Ein halber Credit pro Adresse.

E-Mails an schlechte Adressen schaden deinen Postfächern. Prüf eine Liste vorher. Du zahlst einen halben Credit pro Adresse, die neu geprüft werden muss. Kürzlich geprüfte Adressen sind kostenlos, und das Angebot sagt dir das Maximum, bevor irgendetwas passiert.

Angebot holen, kostenlos

Schick die Adressen, bis zu 5.000 Zeilen und 1.000 verschiedene Adressen pro Prüfung:

Shell
curl -X POST "https://app.argorant.com/api/v1/verifications/quote" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"emails": ["jane.doe@acme.com", "sam@globex.io", "info@initech.example"]}'
JSON
{ "quote_id": "4b1d2c3e4f5a6b7c8d9e0f1a2b3c4d5e", "unique_addresses": 3, "fresh_checks": 2,
  "duplicates_removed": 0, "invalid_rows": [], "maximum_charge": 1, "approval_required": true }

maximum_charge ist das Maximum, das die Prüfung kostet, in Credits. Doppelte Adressen und Zeilen ohne E-Mail fallen kostenlos weg.

Nachfragen, dann starten

Zeig maximum_charge der Person, die zahlt. Nach ihrem Ja:

Shell
curl -X POST "https://app.argorant.com/api/v1/verifications" \
  -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Content-Type: application/json" \
  -d '{"quote_id": "4b1d2c3e4f5a6b7c8d9e0f1a2b3c4d5e", "approved_maximum_charge": 1}'

Die Prüfung prüft genau die Liste aus dem Angebot und kostet nie mehr als approved_maximum_charge. Wenn du dasselbe Angebot erneut startest, bekommst du dieselbe Prüfung zurück.

Ergebnisse lesen

Shell
curl "https://app.argorant.com/api/v1/verifications/$RUN" -H "Authorization: Bearer $ARGORANT_API_KEY"

summary zählt die Ergebnisse. valid kannst du bedenkenlos anschreiben. invalid wird bouncen. catch_all liegt auf einer Domain, die jede Adresse annimmt, und lässt sich daher nicht bestätigen. risky und unknown lässt du besser weg. Die vollständige Liste mit jeder Adresse findest du in der App unter results_url.

Dein Schlüssel braucht den Scope argorant:verify_emails. In der App erstellte Schlüssel haben ihn.

Im Terminal macht npx argorant verify --file my-list.csv -o checked.csv dasselbe in einem Schritt. In Claude oder ChatGPT fragst du: „Prüf die E-Mails in dieser Liste, bevor ich sie anschreibe.“