Zum Inhalt
Werkzeuge

Anrede ergänzen

Fehlende Anreden anhand von Vornamen ergänzen, vorhandene Anreden erhalten und Kontaktlisten als CSV weiterverwenden.

Was ergänzt das Werkzeug?

Anrede ergänzen füllt fehlende Anreden anhand einer lokalen Vornamentabelle. Neu erzeugte Werte lauten Herr oder Frau. Bei unbekannten oder mehrdeutigen Vornamen bleibt die Anrede leer. Vorhandene, nicht leere Anreden bleiben unverändert erhalten. Das API-Produkt heißt salutation.

Die statistische Ableitung verwendet den ersten Vornamen; geben Sie daher Vornamen statt vollständiger Namen an. Bei unbekannten Doppelnamen mit Bindestrich wird der erste Teil geprüft. Schreibvarianten ohne diakritische Zeichen können zugeordnet werden, wenn sie dieselbe Anrede ergeben.

Eine Kontaktliste hochladen

  1. Öffnen Sie Anrede ergänzen in der Konsole.
  2. Laden Sie eine CSV-Datei mit der exakt geschriebenen Spalte first_name hoch. Eine vorhandene Anredespalte heißt salutation; weitere Spalten können beliebige eigene Namen haben.
  3. Prüfen Sie Vorschau und Kostenschätzung und starten Sie den Auftrag.
  4. Laden Sie nach Abschluss die ergänzte Kontaktliste auf derselben Werkzeugseite herunter.
kundennummer,first_name,salutation
K-1001,Max,
K-1002,Erika,Frau
K-1003,,

Anrede-Vorlage herunterladen. Spaltennamen müssen eindeutig und nicht leer sein. Doppelte Kontakte und Zeilen mit fehlenden Vornamen bleiben erhalten; vollständig leere Zeilen werden ausgelassen. Eine Datei darf bis zu 1.000.000 Datenzeilen und 100 MiB haben, mehr als die CSV-Limits der Anreicherung.

Einzelabfrage und CSV per API

curl --fail-with-body "https://api.krake.run/api/v1/salutation/batches/" \
  -H "X-API-Key: $KRAKE_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"input_data":{"first_name":"Max","salutation":""}}'

Eine Einzelabfrage benötigt einen nicht leeren first_name oder eine vorhandene salutation. Sie antwortet direkt mit HTTP 200, batch_id und der normalen Datensatzhülle, darunter id, result und payment_pending. Ein gekürzter Ergebnisausschnitt:

{
  "result": {
    "salutation": "Herr",
    "salutation_status": "assigned"
  },
  "payment_pending": false
}
curl --fail-with-body "https://api.krake.run/api/v1/salutation/batches/csv/" \
  -H "X-API-Key: $KRAKE_API_KEY" \
  -F "file=@anreden.csv;type=text/csv"

CSV-Aufträge antworten mit HTTP 202, batch_id, record_count und estimated_cost_eur. Auftragsstatus, Datensätze, Fortschritt und Export liegen unter /api/v1/salutation/, wie in der Endpunktreferenz beschrieben. Für dieses lokale Werkzeug kann keine Scraper-Auswahl übergeben werden.

Ergebnisstatus und Kosten

Ergebnisse der Anrede-Ergänzung
salutation_statusBedeutungErgebnisgebühr
assignedEine fehlende Anrede wurde als Herr oder Frau ergänzt.Produktpreis pro Datensatz.
existingEine vorhandene Anrede wurde unverändert übernommen.Kostenlos.
ambiguousDer Vorname lässt keine eindeutige Zuordnung zu.Kostenlos.
unknownFür den Vornamen ist keine Zuordnung bekannt.Kostenlos.
no_first_nameEs liegt kein nutzbarer Vorname vor.Kostenlos.

Der Standardpreis beträgt 0,0006 € pro neu ergänzter Anrede, entsprechend 0,60 € für 1.000 Ergänzungen. Maßgeblich ist die Anzeige vor dem Start. Jeder doppelt enthaltene Kontakt mit neu ergänzter Anrede wird separat berechnet.

Die CSV-Vorabprüfung verlangt Guthaben für alle Zeilen mit nicht leerem Vornamen und leerer Anrede. Tatsächlich berechnet werden nur assigned-Ergebnisse. Bei Einzelabfragen benötigen vorhandene, unbekannte oder mehrdeutige Werte kein Guthaben. Reicht es für eine neue Zuordnung nicht, antwortet die Einzelabfrage mit HTTP 402, ohne die Anrede auszugeben oder einen Auftrag anzulegen.

Die Vorabprüfung reserviert kein Guthaben. Wird es durch parallele Aufträge aufgebraucht, kann ein angenommenes Ergebnis auf Zahlung warten: payment_pending=true, result=null. Nach dem Aufladen und der Abrechnung können Sie es erneut abrufen.

Die ergänzte CSV weiterverwenden

Der Export erhält eigene Spalten, ihre Reihenfolge und ihre Werte. Er füllt leere Zellen der Spalte salutation oder hängt diese Spalte an und ergänzt salutation_status. Bei Namenskonflikten erhalten neu angehängte Spalten Endungen wie _2 oder _3. Der Dateiname lautet etwa anreden_3E4BB20688.csv.

Fehlgeschlagene und gestoppte Zeilen bleiben mit failed oder cancelled im Download. Eine unbezahlte Zuordnung bleibt verborgen; der Status lautet dann payment_pending und eine zusätzliche Spalte payment_status zeigt „Zahlung ausstehend“. Laden Sie die Datei nach der Bezahlung erneut herunter.

Gespeicherte Werkzeugergebnisse bleiben auch bei späteren Korrekturen der Vornamentabelle unverändert. Die Anrede im Unternehmensprofil wird dagegen beim Lesen abgeleitet. Die normale Aufbewahrungsfrist gilt auch für dieses Werkzeug.