Skip to main content
Enrow nutzt ein Credit-basiertes System, und Credits werden verbraucht, wenn ein Ergebnis gefunden oder eine Prüfung durchgeführt wird. Diese Seite erklärt, wie Credits für jeden Endpunkt berechnet werden, wie Sie Ihr Guthaben prüfen, wie Sie Abrechnungseinstellungen verwalten und was passiert, wenn die Credits aufgebraucht sind.

Wie funktionieren Credits?

Credits werden nur dann verbraucht, wenn die API ein Ergebnis zurückgibt oder eine Prüfung abschließt: Fehlgeschlagene Abfragen, die nichts finden, kosten keine Credits, mit zwei Ausnahmen beim Email Finder (siehe unten). Jede Funktion verbraucht Credits zu einem anderen Satz:
Credits werden bei Einzel- und Massenvorgängen auf dieselbe Weise berechnet — pro Einzelergebnis. Eine Massen-E-Mail-Suche mit 1.000 Namen kostet pro gefundener E-Mail genauso viel wie 1.000 Einzelsuchen.
Zwei Ausnahmen beim Email Finder: Ein Konto, dessen Erfolgsquote ungewöhnlich niedrig bleibt, zahlt nach einer Warnung 0,25 Credit pro Suche ohne Ergebnis, und eine Suche anhand einer LinkedIn-Profil-URL kostet 0,25 Credit, wenn keine E-Mail gefunden wird. Siehe die FAQ unten.
Jede Anfrage, die Credits verbraucht, gibt in ihrer Antwort ein Feld credits_used zurück, sodass Sie den Verbrauch pro Suche verfolgen können. Ein Beispiel für eine Antwort finden Sie unter Einzelne E-Mail finden.

Wie prüfe ich mein Credit-Guthaben?

Fragen Sie den Konto-Endpunkt mit Ihrem API-Schlüssel im Header x-api-key ab, um Ihr aktuelles Credit-Guthaben abzurufen. Es ist kein Body-Payload erforderlich — das Konto wird anhand des API-Schlüssels identifiziert.
Antwort
Die Antwort enthält Ihr Guthaben und die registrierten Webhooks: Die vollständige Endpunkt-Referenz finden Sie unter Konto-Info. Sie können auch Ihr Dashboard besuchen, um Nutzungs- und Abrechnungsdetails einzusehen, oder den Leitfaden Authentifizierung lesen, um zu verstehen, wie der Header x-api-key über alle Endpunkte hinweg funktioniert.

Wie verwalte ich Abrechnungseinstellungen?

Bei kostenpflichtigen Tarifen finden Sie unter Abrechnung → Einstellungen in der App zwei Einstellungen, die Ihr Konto mit Credits versorgen und Sie warnen, bevor diese aufgebraucht sind:
Füllt Ihr Guthaben automatisch auf, sobald es unter den von Ihnen festgelegten Credit-Schwellenwert fällt (mindestens 100 Credits). Wählen Sie einen von zwei Modi:
  • Vorzeitige Verlängerung: Ihr Tarif verlängert sich sofort und beginnt mit seinen Credits einen neuen Zyklus. Nur mit einem aktiven Abonnement verfügbar.
  • Nutzungsbasierte Aufladung: Es wird ein Paket Pay-as-you-go-Credits im von Ihnen gewählten Aufladevolumen gekauft.
Liegt Ihr Guthaben beim Speichern bereits unter dem Schwellenwert, erfolgt die Aufladung sofort.
Sendet eine E-Mail an die von Ihnen gewählte Adresse, wenn Ihr Guthaben unter eine bestimmte Credit-Menge fällt. Sie können diese Warnung auch in einem Slack- oder Discord-Kanal posten.

Was passiert, wenn die Credits aufgebraucht sind?

Wenn Ihr Credit-Guthaben null erreicht, geben API-Anfragen den HTTP-Status 402 zurück. Einzel-Endpunkte (E-Mail-/Telefon-Einzelsuche, Einzelprüfung) geben Folgendes zurück:
Massen-Endpunkte geben stattdessen { "message": "..." } zurück. Die vollständige Liste der Statuscodes und Antwortformate finden Sie unter Statuscodes und Fehlerbehandlung.
Um Unterbrechungen zu vermeiden, aktivieren Sie unter Abrechnung → Einstellungen den Guthabenschutz oder eine Credit-Warnung.

Welchen Tarif soll ich wählen?

Besuchen Sie enrow.io/pricing, um Tarife zu vergleichen und den passenden für Ihre Anforderungen zu finden. Pay-as-you-go-Credits können zu jedem Tarif hinzugefügt werden, manuell oder automatisch mit dem Guthabenschutz.

FAQ

Nein. Credits werden nur verbraucht, wenn eine E-Mail oder Telefonnummer gefunden oder eine Verifizierungsprüfung durchgeführt wird. Eine Suche, die kein Ergebnis liefert, kostet keine Credits. Eine Ausnahme, geregelt in Ziffer 8.6 unserer Nutzungsbedingungen: Finden weniger als 12 % der Email-Finder-Suchen eines Kontos eine E-Mail, bei mindestens 10.000 Suchen in 7 Tagen, warnen wir das Konto per E-Mail. Liegt die Quote 7 Tage später immer noch so niedrig, kostet jede Email-Finder-Suche ohne Ergebnis 0,25 Credit, bis die Quote wieder steigt. Eine weitere Ausnahme: Eine Email-Finder-Suche anhand einer LinkedIn-Profil-URL kostet 0,25 Credit, wenn keine E-Mail gefunden wird. Fehlschläge durch einen Vorfall auf unserer Seite werden nie berechnet.
Nein. Credits werden pro Einzelergebnis berechnet, sodass ein Massenvorgang pro gefundener E-Mail, Telefonnummer oder Verifizierung genauso viel kostet wie die entsprechenden Einzelanfragen. Massen-Endpunkte sparen Anfragen, nicht Credits.
Der Email Verifier verbraucht 0,25 Credits pro Prüfung. Der Email Finder verbraucht 1 Credit pro gefundener E-Mail, und der Phone Finder verbraucht 40 Credits pro gefundener Telefonnummer (50 bei Legacy-Tarifen).
Anfragen geben den HTTP-Status 402 zurück. Einzel-Endpunkte geben { "reason": "Insufficient credits", "success": false } zurück, während Massen-Endpunkte { "message": "..." } zurückgeben. Weitere Details finden Sie unter Fehlerbehandlung.

Nächste Schritte

Authentifizierung

So übergeben Sie Ihren API-Schlüssel im Header x-api-key.

Konto-Info

Rufen Sie Ihr Credit-Guthaben und die registrierten Webhooks ab.

Rate-Limits

Verstehen Sie die API-Anfragelimits, bevor Sie skalieren.

Fehlerbehandlung

Behandeln Sie 402 und andere Fehlerantworten elegant.