REST: POST /api/mcp/email/verify und /verify/batch

Die Prüf-Endpunkte prüfen Adressen, die du schon hast. Jede Prüfung kostet einen halben Credit aus demselben Guthaben wie Kontakte, und erneute Prüfungen kürzlich geprüfter Adressen sind kostenlos.

Einzelne Adresse

curl -X POST -H "Authorization: Bearer ag_live_..." \
  -H "Content-Type: application/json" \
  -d '{"email": "someone@company.com"}' \
  https://app.argorant.com/api/mcp/email/verify

Die Antwort enthält die Adresse, einen Status und ein Kennzeichen für Zustellbarkeit. Auf dieses Kennzeichen sollte dein Code verzweigen.

Batch

curl -X POST -H "Authorization: Bearer ag_live_..." \
  -H "Content-Type: application/json" \
  -d '{"emails": ["a@company.com", "b@company.com"]}' \
  https://app.argorant.com/api/mcp/email/verify/batch

Schick bis zu 500 Adressen pro Anfrage und teil alles Größere auf. Die Batch-Antwort liefert eine Ergebniszeile pro Adresse plus zwei Zähler: wie viele Prüfungen berechnet wurden und wie viele aus einer aktuellen Prüfung kamen und daher kostenlos waren.

Antwort der Batch-Prüfung mit Ergebnissen und den Zählern für berechnete und kostenlose Prüfungen

Hinweise

Entferne Dubletten vor dem Senden. Doppelte Adressen in einer Anfrage verschwenden Prüfungen.
Catch-all-Postfächer nehmen alles an, also kann kein Prüfdienst sie vollständig auflösen. Sie werden ehrlich gekennzeichnet statt geraten.
Aus Argorant exportierte Kontakte sind beim Export schon verifiziert. Nutze diese Endpunkte für Listen, die von woanders kommen.

Das CLI-Gegenstück ist argorant verify, einschließlich eines CSV-Modus, der die Datei für dich aufteilt.