Question 1

Was passiert, wenn ein Name sowohl männlich, als auch weiblich sein kann?

Accepted Answer

Je nach API-Version oder der von dir verwendeten Integration geben unsere Endpunkte entweder einen Genauigkeits- oder einen Wahrscheinlichkeitswert in der Antwort zurück. Der Genauigkeitsparameter gibt an, wie sicher wir sind, dass dieser Name entweder männlich oder weiblich ist. Der Wert wird anhand der Anzahl der Datensätze in unserer Datenbank berechnet. Wenn wir zum Beispiel 100 Datensätze zu einem Namen haben und 96 davon weiblich und 4 männlich sind, beträgt die Genauigkeit 96 % (oder eine Wahrscheinlichkeit von 0,96). Eine geringe Genauigkeit bedeutet, dass dieser Name wahrscheinlich von mehreren Geschlechtern verwendet wird und keinem bestimmten Geschlecht zugeordnet werden kann.

Question 2

Kann es für ein und denselben Namen pro Land Unterschiede geben?

Accepted Answer

Während der Name Andrea in Italien männlich ist, ist Andrea in Deutschland ein weiblicher Vorname. In den USA kann der Name sogar beides sein. In diesem Fall geben wir im Abfrageergebnis einen Genauigkeitswert zwischen 0 und 100 an (oder einen Wahrscheinlichkeitswert zwischen 0 und 1). Er gibt an, wie sicher wir sind, dass wir das richtige Geschlecht erkannt haben. Du kannst die Qualität des Abfrageergebnisses erheblich steigern, indem du geografische Informationen zu deiner Abfrage mitschickst. Das kann ein Ländercode, das Gebietsschema des Browsers oder eine IP-Adresse sein. Mehr zur Lokalisierung einer Abfrage findest du in unserer API-Dokumentation.

Question 3

Wie werden die Daten gesammelt?

Accepted Answer

Um eine möglichst hohe Genauigkeit zu erreichen, kombinieren wir Daten aus verschiedenen Quellen. Die wichtigsten Quellen für neue Einträge sind öffentlich zugängliche Daten, Regierungsdaten und manuelle Ergänzungen bzw. Korrekturen. Je nach Quelle muss ein neuer Name von einer zweiten Quelle bestätigt werden, bevor er in unsere Liste aufgenommen wird. Wenn wir zum Beispiel einen Namen aus öffentlich verfügbaren Daten hinzufügen, braucht dieser Name möglicherweise eine zweite Überprüfung, etwa eine manuelle Bestätigung, bevor er endgültig in unsere Datenbank aufgenommen wird. Eine Liste der unterstützten Länder findest du hier.

Question 4

Wie oft werden die Namen in eurer Datenbank aktualisiert?

Accepted Answer

Wir aktualisieren unsere Daten regelmäßig, je nach Land und den verfügbaren öffentlichen Daten. Die meisten westlichen Länder werden einmal im Jahr aktualisiert. Außerdem kann sich über die Jahre ändern, wie sich ein Name auf die Geschlechter verteilt. Wenn ein Name in den 1970er Jahren zum Beispiel ausschließlich von Frauen verwendet wurde, kann er Jahrzehnte später überwiegend von Männern benutzt werden. Aus diesem Grund verwenden wir für mehrere Länder, etwa die USA, auch Geburtsdaten, um die Ergebnisse zu verbessern. Unsere Modelle berücksichtigen all diese Faktoren so gut wie möglich. Der zurückgegebene Genauigkeitswert wird regelmäßig angepasst, um die tatsächliche Nutzung in der Bevölkerung so genau wie möglich widerzuspiegeln. Der Wert soll eine angemessene Bewertung auf Grundlage der letzten Jahrzehnte liefern und kann eine mögliche Schwankung ausdrücken. Wir betrachten dabei etwa die letzten 4 Jahrzehnte. Wenn du eine Abfrage durchführst und dieselbe Abfrage ein Jahr später wiederholst, kann das Ergebnis abweichen, weil unser System alte Daten entfernt und neue Daten hinzugekommen sein können. Jedes Mal, wenn neue Daten hinzukommen, führen wir anschließend sogenannte Integrationstests durch. Dabei wird unsere API gegen einen zuvor validierten Datensatz getestet, um die Qualität sicherzustellen. Dieser Datensatz wird kontinuierlich um Namen und Testfälle erweitert, um eine möglichst breite Abdeckung zu erreichen.

Question 5

Wie nutzt ihr KI?

Accepted Answer

Künstliche Intelligenz (KI) wird täglich genutzt, um die Qualität unserer Datenbank und API-Ergebnisse zu verbessern. Mit Hilfe von KI können wir effizient und präzise neue Einträge in unsere Datenbank aufnehmen und sicherstellen, dass unsere Informationen immer auf dem neuesten Stand sind. Darüber hinaus spielt KI auch eine wichtige Rolle bei der Verbesserung der Gesamtqualität unserer API-Ergebnisse. Durch den Einsatz von Machine-Learning-Algorithmen können wir Daten effektiver analysieren, Muster erkennen und unseren Benutzern genauere und relevantere Ergebnisse liefern.

Question 6

Bietet ihr Hilfe bei der Implementierung der API an?

Accepted Answer

Ja, wir bieten E-Mail-Support für alle Kunden an. Du kannst uns eine E-Mail an contact gender-api.com schicken. Wir melden uns dann so schnell wie möglich bei dir. Programmierbeispiele findest du hier. Bitte beachte, dass wir dir nicht bei jeder Programmiersprache und jedem Anwendungsfall helfen können. In den meisten Fällen kannst du einen gewöhnlichen REST-Client in deiner Anwendung verwenden, um unsere API abzufragen. Viele Bibliotheken unterstützen auch den Import einer OpenAPI-Definitionsdatei. Unsere openapi.yml kannst du hier herunterladen.

Question 7

Was ist, wenn wir ein hohes Maß an Genauigkeit benötigen?

Accepted Answer

Sprachen und Namen sind veränderlich und ändern sich im Lauf der Zeit. Von Kunde zu Kunde können Datensätze auch in Qualität, Umfang und Herkunft stark variieren. Daher können wir nicht garantieren, dass alle Ergebnisse, die du von unserer API erhältst, zu 100% korrekt und in Übereinstimmung mit deinem Datensatz sind. Aber wir können versprechen, dass wir uns immer darum bemühen, dir die bestmöglichen Ergebnisse zu liefern, und dass wir unsere Algorithmen regelmäßig verbessern und aktualisieren. Wir fügen auch regelmäßig neue Daten hinzu. Mehr Informationen zu unseren Updates findest du hier. Im unwahrscheinlichen Fall, dass unser Service nicht deinen Erwartungen entspricht, geben wir dir eine unkomplizierte 14-tägige Geld-zurück-Garantie. Natürlich kannst du unseren Service auch vollständig kostenlos testen. Wenn du dich hier registrierst, erhältst du 100 Anfragen kostenlos pro Monat. Wenn du einen Namen abfragst, geben unsere Endpunkte je nach API-Version entweder einen Genauigkeits- oder einen Wahrscheinlichkeitswert in der Antwort zurück. Der Genauigkeitsparameter gibt an, wie sicher wir sind, dass dieser Name männlich oder weiblich ist. Der Wert wird anhand der Anzahl der passenden Einträge in unserer Datenbank berechnet. Da sich die Anwendungsfälle stark unterscheiden, geben wir keine Empfehlung für ein Genauigkeitsniveau. Je nach Anwendungsfall entscheidest du selbst, welche Ergebnisse und Genauigkeitswerte du akzeptierst. Selbst bei einer Genauigkeit von mindestens 99 % kann das Ergebnis falsch sein. Ein Wert über 95 % passt aber für die meisten Anwendungsfälle.

Question 8

Wie viele Namen habt ihr insgesamt gespeichert?

Accepted Answer

Unsere Datenbank enthält 6,084,389 validierte Namen aus 191 verschiedenen Ländern. Weltweit haben wir 6,450,268 eindeutige Namen gespeichert. Im Durchschnitt analysieren wir rund 10.000.000 Datensätze pro Monat, um die Qualität unserer Ergebnisse zu verbessern.

Question 9

Welche Länder werden unterstützt?

Accepted Answer

Die API unterstützt 191 Länder vollständig. Vollständig unterstützt bedeutet, dass wir für das jeweilige Land mindestens  Namen gesammelt haben. Für die meisten Länder ist unser Datenbestand aber deutlich größer. In der folgenden Tabelle siehst du, wie viele Namen wir für welches Land unterstützen. Bedenke: Auch wenn wir für ein Land keine ausreichende Unterstützung bieten, kannst du die gesuchten Namen weiterhin gegen den gesamten Datenbestand abfragen und so ein brauchbares Ergebnis erhalten.

Question 10

Werden auch arabische Namen unterstützt?

Accepted Answer

Ja, unsere API unterstützt arabische Namen. Diese können auch mit Buchstaben des arabischen Alphabets geschrieben werden.
        Arabisch wird von rechts nach links in Schreibschrift geschrieben und umfasst 28 Buchstaben.
        Wenn du zum Beispiel "عبد ال" abfragst, erhältst du das folgende Ergebnis: "gender": "male" , "accuracy": 100.
        Der arabische Name "عبد ال" ist in diesem Beispiel urlencodiert und die Abfrage-URL würde wie folgt aussehen: https://gender-api.com/get?name=%D8%B9%D8%A8%D8%AF%20%D8%A7%D9%84&key=YOUR_API_KEY.
        Du findest eine vollständige Liste aller unterstützten Länder hier.

Question 11

Kann ich mehrere Namen in einer Anfrage abfragen?

Accepted Answer

Ja, das ist problemlos möglich. Du kannst bis zu 100 Namen gleichzeitig abfragen. Details dazu findest du in unserer API-Dokumentation.

Question 12

Was genau macht die E-Mail-API?

Accepted Answer

Unsere E-Mail-API kann Namen aus E-Mail-Adressen extrahieren und das passende Geschlecht zu dieser Adresse liefern. Das hilft dir, deine Mailings mit einer korrekten Anrede zu personalisieren. Aus der E-Mail-Adresse „marie.johnson@gmail.com“ extrahiert die API zum Beispiel den Namen „Marie“ und bestimmt das richtige Geschlecht, in diesem Fall „female“. Details dazu findest du in unserer API-Dokumentation.

Question 13

Ich habe sehr viele Datensätze. Kann ich sie gesammelt als CSV-Datei hochladen?

Accepted Answer

Als registrierter Nutzer kannst du jede CSV-Datei hochladen, die eine Spalte mit Vornamen enthält. Für ein besseres Ergebnis kannst du deinem Datensatz optional eine Spalte mit dem Land hinzufügen. Die Spalten müssen nicht besonders benannt sein — unser Assistent führt dich durch den Prozess und lässt dich wählen, welche Spalte den Vornamen und welche das Land enthält. Du findest die Funktion in deinem Account. Verarbeitete Datenzeilen werden wie Anfragen berechnet, du kannst also jeden Monat kostenlos eine CSV-Datei mit bis zu 100 Zeilen hochladen. Der CSV-Massenupload setzt einen Gender-API.com-Account voraus. Aus Datenschutzgründen werden hochgeladene Dateien nach einem Jahr automatisch gelöscht.

Question 14

Wie muss die CSV-Datei formatiert sein?

Accepted Answer

Wir unterstützen CSV-Dateien, die unter Windows, macOS oder Linux erstellt wurden. Außerdem unterstützen wir Dateien mit „;“, „,“ oder Tab als Trennzeichen. Als Textbegrenzer muss ein " verwendet werden. Es werden auch CSV-Dateien mit mehrzeiligen Datensätzen unterstützt, mit maximal 10.000.000 Zeilen und 301 MB pro Datei. Für das bestmögliche Ergebnis empfehlen wir eine UTF-8-codierte CSV-Datei mit Semikolon als Trennzeichen. Die Datei kann beliebige weitere Spalten enthalten, die auch in der Ausgabedatei erhalten bleiben. Sie muss mindestens eine Spalte mit Vornamen oder eine Spalte mit vollständigen Namen enthalten. Klicke hier, um eine Beispieldatei herunterzuladen. Bitte erstelle einen Gender-API.com-Account, um eine CSV-Datei hochladen zu können.

Question 15

Kann ich eine Excel-Datei hochladen?

Accepted Answer

Du kannst Excel-Dateien mit bis zu 300.000 Zeilen hochladen. Für größere Datenmengen nutze bitte unseren CSV-Upload. Wir unterstützen .xlsx-Dateien mit einem einzelnen Tabellenblatt. Wenn du eine Datei mit mehr als einem Tabellenblatt hochlädst, wird nur das erste verarbeitet. Die erste Zeile deines Tabellenblatts muss die Spaltennamen enthalten. Die Datei muss mindestens eine Spalte mit Vornamen enthalten, die Länderspalte ist optional. Aus Datenschutzgründen werden hochgeladene Dateien nach einem Jahr automatisch gelöscht. Beispieldatei hier herunterladen. Beispiel:

Question 16

Ich habe einen Fehler gefunden. Was nun?

Accepted Answer

Wir freuen uns über jede Hilfe. Schicke uns bitte eine E-Mail an contact gender-api.com, und wir versuchen, den Fehler so schnell wie möglich zu beheben.

Question 17

Ist Gender-API mit der Datenschutz-Grundverordnung (DSGVO) konform?

Accepted Answer

Alle Dienste von Gender-API.com sind vollständig DSGVO-konform. Wir stellen einen Auftragsverarbeitungsvertrag (DPA) bereit, mit dem du deinen DSGVO-Pflichten nachkommen kannst. Den Vertrag kannst du hier in deinem Konto anfordern. Einen Mustervertrag kannst du hier herunterladen. Mehr Informationen dazu, wie wir deine Daten schützen, findest du hier.

Question 18

Gibt es Bibliotheken für Programmiersprachen?

Accepted Answer

Wegen der Einfachheit unserer API bieten wir außer dem jQuery-Plugin keine eigenen Bibliotheken an. Die meisten Sprachen bringen von Haus aus einen JSON-Parser mit, und für fast jede andere Sprache gibt es bereits eine externe Bibliothek, die du nutzen kannst. Schau dir unsere Programmierbeispiele an, um mit der API zu starten:

Question 19

Wie werden Anfragen gezählt?

Accepted Answer

Jedes Konto wird am ersten Tag eines Monats auf 100 Anfragen aufgeladen, wenn weniger als diese Anzahl übrig ist. Eine Anfrage wird nur gezählt, wenn ein Ergebnis gefunden wurde. Eine Namensabfrage zählt als eine Anfrage. Wenn mehrere Namen in einer Abfrage übergeben werden, zählt jeder Name als eigene Anfrage.

Question 20

Wo kann ich meine API-Schlüssel finden und verwalten?

Accepted Answer

Wir erzeugen einen ersten API-Schlüssel, wenn du dich für ein Gender-API.com-Konto registrierst. Du findest diesen API-Schlüssel unten auf der Übersichtsseite deines Kontos. Wenn du den Schlüssel widerrufen möchtest, klicke auf "Widerrufen und neu generieren". Unser System macht den bestehenden API-Schlüssel dann ungültig und erzeugt einen neuen. Alle deine Anwendungen, die den alten Schlüssel verwenden, können danach nicht mehr auf unsere API zugreifen, bis du ihn durch den neuen API-Schlüssel ersetzt hast. [apiKeyImage] Du kannst auch mehr als einen API-Schlüssel anlegen. Das ist zum Beispiel praktisch, wenn du mehrere Anwendungen hast, in die du unsere API einbauen willst. Bitte beachte, dass zwischen den einzelnen Schlüsseln und deren Anzahl der Nutzung kein Unterschied besteht. Alle Anfragen werden zusammen gezählt. Um mehrere API-Schlüssel zu erstellen oder zu verwalten, klicke auf die "Einstellungen"-Schaltfläche im Kontomenü und dann auf "API-Schlüssel".
        [multipleKeysImage] Durch Klicken auf die Schaltfläche "Neuen Schlüssel erstellen" kannst du einen neuen API-Schlüssel generieren. Du kannst jedem Token einen Namen geben, um später leichter erkennen zu können, wo dieser Schlüssel verwendet wurde. Du kannst diesen Namen jederzeit ändern. Einige unserer Widgets werden hier auch automatisch einen Schlüssel generieren. Wenn du beispielsweise unser "Schnellabfrage-Widget" in deinem Konto verwendest, wird unser System im Voraus einen Schlüssel generieren, den dieses Widget dann zum Abfragen unserer API verwendet.
        Außerdem wird jede Drittanbieter-App hier einen Schlüssel erstellen, sobald sie verbunden ist. Jeder Token kann jederzeit durch Klicken auf das "x" widerrufen werden. Sobald er widerrufen wird, hat die verbundene Anwendung keinen Zugriff mehr auf unsere API.

Question 21

Kann ich mein Konto mit mehreren Personen teilen?

Accepted Answer

Du kannst dein Konto mit bis zu 50 weiteren Kollegen oder anderen Personen teilen, die an deinem Projekt mitarbeiten. Um dein Team zu verwalten, melde dich in deinem Konto an und klicke im Kontomenü auf "Einstellungen" => "Team verwalten". Klicke auf dieser Seite auf "Neues Mitglied einladen", um Personen per E-Mail in dein Team einzuladen. Beim Einladen kannst du zwischen zwei Kontotypen wählen. A) Benutzer können API-Schlüssel ansehen, erstellen, ändern und widerrufen, CSV- und Excel-Dateien hochladen und das Geschlecht bestimmen lassen, alle API-Endpunkte nutzen, Anfragen kaufen und Apps von Drittanbietern verbinden. B) Administratoren können all das ebenfalls und zusätzlich Kontoeinstellungen und Rechnungsadresse ändern, Auftragsverarbeitungsverträge erstellen und ansehen sowie Teammitglieder einladen, ändern und löschen.

Question 22

Kann ich mein Konto mit der Zwei-Faktor-Authentifizierung schützen?

Accepted Answer

Du kannst dein Konto schützen, indem du die Zwei-Faktor-Authentifizierung aktivierst. Um diese zusätzliche Sicherheitsmaßnahme zu aktivieren, melde dich in deinem Konto an und klicke im Menü auf "Einstellungen" => "Passwort ändern / 2FA". Stelle sicher, dass auf deinem Telefon eine Authenticator-App installiert ist. Wir empfehlen eine App wie Authy (App Store, Play Store) oder Google Authenticator (App Store, Play Store). Klicke dann auf "Jetzt aktivieren" und folge den Anweisungen auf dem Bildschirm. Du kannst hier mehrere Geräte hinzufügen, damit du zum Beispiel auch nach dem Verlust eines Geräts weiterhin Zugriff auf dein Konto hast. Nach der Aktivierung musst du zum Anmelden den Code eingeben, den die Authenticator-App auf deinem Telefon erzeugt.

Question 23

Kann ich Apps von Drittanbietern verwenden, wenn die Zwei-Faktor-Authentifizierung aktiviert ist?

Accepted Answer

Einige Integrationen und Apps von Drittanbietern funktionieren einwandfrei, wenn die Zwei-Faktor-Authentifizierung aktiviert ist. Bei anderen kann es nötig sein, sie ohne Zwei-Faktor-Authentifizierung zu verbinden. Wenn du Probleme hast, dich mit deinen Gender-API.com-Zugangsdaten in einer App anzumelden, melde dich direkt in deinem Konto auf Gender-API an und klicke im Kontomenü auf "Einstellungen" => "Passwort ändern / 2FA". Klicke dann auf den Reiter "Zwei-Faktor-Authentifizierung" und setze "Zugriff durch Drittanbieter-Apps" auf "Nicht eingeschränkt". Bitte beachte, dass du diese Einstellung nur ändern kannst, wenn die Zwei-Faktor-Authentifizierung aktiviert ist.

Question 24

Was sind Passkeys und wie funktionieren sie?

Accepted Answer

Passkeys sind eine moderne, passwortlose Methode zur Authentifizierung und bieten mehr Sicherheit als herkömmliche Passwörter. Statt ein Passwort einzugeben, meldest du dich mit den integrierten Sicherheitsfunktionen deines Geräts an — zum Beispiel Face ID, Touch ID, Windows Hello oder einer PIN. Passkeys basieren auf dem WebAuthn-Standard und sind phishing-resistent, weil sie kryptografisch an eine bestimmte Website gebunden sind. Dein privater Schlüssel verlässt dein Gerät nie — dadurch sind Passkeys sicherer als Passwörter. Sobald du für dein Gender-API.com-Konto einen Passkey eingerichtet hast, meldest du dich mit einer Berührung oder einem Blick an, ganz ohne Passwort. Passkeys funktionieren geräteübergreifend und lassen sich über iCloud-Schlüsselbund, Google Password Manager oder ähnliche Dienste synchronisieren.

Question 25

Wie richte ich einen Passkey für mein Konto ein?

Accepted Answer

Ein Passkey wird automatisch während der Anmeldung eingerichtet. Wenn du dich mit deiner E-Mail-Adresse und deinem Passwort anmeldest, wirst du gefragt, ob du für schnellere künftige Anmeldungen einen Passkey erstellen möchtest. Folge einfach den Anweisungen auf deinem Gerät — dein Browser bittet dich, deine Identität mit Face ID, Touch ID, Windows Hello oder der PIN deines Geräts zu bestätigen. Danach wird der Passkey automatisch auf deinem Gerät gespeichert und ist sofort einsatzbereit. Beim nächsten Besuch auf Gender-API.com meldest du dich direkt mit deinem Passkey an, statt dein Passwort einzutippen. Du kannst die Einrichtung auch überspringen, wenn du weiterhin dein Passwort verwenden möchtest. Hinweis: Passkeys setzen einen kompatiblen Browser (Chrome, Safari, Edge, Firefox) und ein kompatibles Betriebssystem voraus.

Question 26

Wie unterscheiden sich Passkeys von der Zwei-Faktor-Authentifizierung (2FA)?

Accepted Answer

Beide erhöhen die Sicherheit, funktionieren aber unterschiedlich. Die Zwei-Faktor-Authentifizierung (2FA) fügt nach der Passworteingabe einen zweiten Faktor hinzu, meist einen Code aus einer Authenticator-App. Passkeys ersetzen dein Passwort vollständig und bieten Mehr-Faktor-Sicherheit in einem einzigen Schritt: Sie verbinden etwas, das du hast (dein Gerät), mit etwas, das du bist (Biometrie), oder etwas, das du weißt (Geräte-PIN).
Passkeys gelten als sicherer, weil sie phishing-resistent sind (sie funktionieren nur auf der echten Website), von Passwort-Datenlecks nicht betroffen sind und weder erraten noch geknackt werden können.
Wenn du Passkeys und 2FA aktiviert hast, überspringt die Anmeldung mit einem Passkey die 2FA-Abfrage, weil Passkeys bereits eine gleichwertige oder höhere Sicherheit bieten.

Question 27

Was passiert, wenn ich das Gerät mit meinem Passkey verliere?

Accepted Answer

Wenn du ein Gerät mit deinem Passkey verlierst: keine Sorge — dein Konto bleibt sicher und zugänglich. Du kannst dich jederzeit mit deinem Passwort anmelden (und mit 2FA, falls aktiviert). Wenn deine Passkeys über iCloud-Schlüsselbund oder Google Password Manager synchronisiert werden, stehen sie automatisch auch auf deinen anderen Geräten zur Verfügung, auf denen du mit demselben Konto angemeldet bist. Für optimale Sicherheit empfehlen wir: Passkeys auf mehreren Geräten einrichten, das Passwort als Rückfalloption behalten und 2FA als zusätzliche Sicherheitsebene aktivieren. In deinen Kontoeinstellungen kannst du außerdem deine Passkeys verwalten, um den Passkey eines verlorenen Geräts zu entfernen und unbefugten Zugriff zu verhindern.

Question 28

Was ist der Unterschied zwischen einem bezahlten und einem kostenlosen Konto?

Accepted Answer

Beide Kontotypen bieten die gleichen Funktionen. Alle API-Endpunkte stehen für beide Kontotypen zur Verfügung und liefern die gleichen Ergebnisse. Kostenlose Konten sind auf eine bestimmte Anzahl von Anfragen pro Monat begrenzt. Direkt nach der Registrierung stehen dir 100 Anfragen kostenlos zur Verfügung. Am ersten Tag jedes Monats setzt unser System diesen Zähler zurück und die kostenlosen Anfragen stehen wieder zur Verfügung. Bitte erstelle nur ein Konto. Wenn du mehr Anfragen brauchst, kannst du jederzeit hier auf eines unserer kostenpflichtigen Pakete upgraden.

Question 29

Wie kann ich mich von allen Geräten abmelden?

Accepted Answer

Wenn du auf die Abmelden-Schaltfläche in deinem Konto klickst, wirst du nur von deinem aktuellen Gerät abgemeldet. Um die Sicherheit deines Kontos und deiner Daten zu gewährleisten, ist es wichtig, dich bei Bedarf von allen Geräten abzumelden. Befolge bitte die Anweisungen unten, um dich erfolgreich von allen Geräten auf unserer API-Plattform abzumelden. Wenn du angemeldet bist, klicke hier, um von allen Geräten abgemeldet zu werden. Außerdem wirst du automatisch von allen Geräten ausgeloggt, die nicht mit deiner aktuellen IP-Adresse übereinstimmen, wenn du dein Passwort änderst oder deine Zwei-Faktor-Authentifizierungseinstellungen modifizierst. Dies fügt eine zusätzliche Sicherheitsebene zu deinem Konto hinzu. Es wird empfohlen, getrennte Konten für jedes Teammitglied zu erstellen, um die Sicherheit zu erhöhen und das Team-Management zu erleichtern. Darüber hinaus empfehlen wir dringend, die Zwei-Faktor-Authentifizierung (2FA) zu aktivieren, um die Sicherheit deines Kontos zu verbessern. Diese zusätzliche Schutzschicht erschwert es unbefugten Personen, Zugriff zu erhalten, indem ein zusätzlicher Schritt im Anmeldeprozess erforderlich ist.

Question 30

Was ist der Unterschied zwischen einem Abonnement und einem Einmal-Kauf?

Accepted Answer

Wenn du eines unserer Pakete kaufen möchtest, hast du die Wahl zwischen einer einmaligen Zahlung und einem Abonnement. Abonnements sind empfehlenswert, wenn du unseren Dienst regelmäßig nutzt. So kannst du sicher sein, dass in deinem Konto immer genügend Anfragen übrig sind. Mit einem Abonnement gekaufte Anfragen können innerhalb eines Monats genutzt werden. Bei einem aktiven Abonnement lädt unser System dein Konto nach einem Monat wieder auf die gewählte Anzahl an Anfragen auf. Wenn du zum Beispiel unser Paket mit 25.000 Anfragen abonniert hast und 21.500 verbraucht hast, füllt unser System dein Konto nach einem Monat wieder auf 25.000 Anfragen auf. Einmal-Pakete kannst du für einen einzelnen Anwendungsfall kaufen und innerhalb eines Jahres nutzen. Wenn du zum Beispiel eine Excel- oder CSV-Datei verarbeiten möchtest, empfehlen wir den Einmalkauf. Einmalkäufe verlängern sich nicht — du musst selbst darauf achten, dass dir die Anfragen nicht ausgehen. Zwischen beiden Pakettypen kannst du auf unserer Kaufseite wechseln.

[difference]
Bitte mische die beiden Kaufarten nicht, bevor du mit unserem Support gesprochen hast oder genau weißt, was du tust. Wenn du ein Einmal-Paket kaufst, während du ein Abonnement hast, kann das dazu führen, dass das Abonnement deine Anfragen nicht mehr auffüllt — zum Beispiel dann, wenn aus dem Einmalkauf mehr Anfragen übrig sind, als das Abonnement nachfüllen würde.

Question 31

Ich benötige eine Ansässigkeitsbescheinigung. Könnt ihr uns so eine Bescheinigung ausstellen?

Accepted Answer

Wenn du eine Bescheinigung über den Sitz unseres Unternehmens brauchst, wende dich mit deiner Anfrage bitte an unseren Support. Die Bescheinigung muss für jedes Unternehmen einzeln angefordert werden. Gib in deiner Anfrage die vollständige Adresse deines Unternehmens, dein Sitzland und, falls vorhanden, deine Steuernummer an. Die Ansässigkeitsbescheinigung muss von unserem Finanzamt unterschrieben werden. Normalerweise dauert es 2–3 Wochen, bis wir das unterschriebene Formular erhalten, das wir dir dann als digitalen Scan bereitstellen können.

[certificate-of-residence]

Question 32

Wie kann ich ein Paket bzw. mehr Anfragen kaufen?

Accepted Answer

Du kannst hier zwischen einem Abonnement und einem Einmalkauf wählen. Ein Einmalkauf ist zu empfehlen, wenn du eine große CSV-Datei verarbeiten willst oder deine Anfragen unregelmäßig nutzt. Du kannst dein Konto jederzeit mit der benötigten Anzahl an Anfragen aufladen. Mit einem Einmalkauf erworbene Anfragen können innerhalb eines Jahres genutzt werden. Wenn du dich für ein Abonnement entscheidest, wird dein Konto jeden Monat wieder auf die gewählte Anzahl an Anfragen aufgefüllt. Abonnements können jederzeit geändert oder gekündigt werden.

Question 33

Wie kann ich mein Abonnement kündigen?

Accepted Answer

Du kannst dein Abonnement hier jederzeit ändern oder kündigen. Wenn du die wiederkehrenden Zahlungen stoppen möchtest, klicke auf die Schaltfläche "Abonnement kündigen".

Question 34

Wie hoch ist die typische API-Antwortzeit?

Accepted Answer

Unsere API ist auf hohe Leistung ausgelegt und antwortet in der Regel innerhalb von 10–200 Millisekunden. Die Antwortzeiten können je nach deinem geografischen Standort, den Netzwerkbedingungen und der Komplexität deiner Anfrage leicht schwanken. Bei Batch-Anfragen mit mehreren Namen steigt die Antwortzeit linear. Wir nutzen ein globales CDN und eine optimierte Infrastruktur, um weltweit eine geringe Latenz sicherzustellen. Wenn du dauerhaft langsame Antwortzeiten feststellst, wende dich bitte an unser Support-Team.

Question 35

Gibt es irgendwelche Rate-Limits oder Beschränkungen für Anfragen?

Accepted Answer

Wir setzen faire Nutzungslimits, damit der Dienst für alle Nutzer optimal funktioniert. Kostenlose Konten können bis zu 100 Anfragen pro Monat stellen. Kostenpflichtige Konten haben höhere Limits: 1500 Anfragen pro Minute und keine Tagesbegrenzung, solange du Credits verfügbar hast. Wenn du für deinen Anwendungsfall höhere Limits brauchst, kontaktiere uns, um ein individuelles Paket zu besprechen. Batch-Anfragen (bis zu 100 Namen pro Anfrage) zählen als einzelne Anfragen, sind aber effizienter.

Question 36

Wie hoch ist eure garantierte API-Verfügbarkeit?

Accepted Answer

Wir garantieren 99,9 % Verfügbarkeit der API für alle kostenpflichtigen Pakete. Unsere Infrastruktur läuft auf Servern in Enterprise-Qualität mit automatischem Failover und Lastverteilung. Wir überwachen unsere Systeme rund um die Uhr (24/7) und haben automatische Benachrichtigungen für Störungen eingerichtet.

Für Unternehmenskunden stellen wir außerdem ein Service Level Agreement (SLA) bereit. Im seltenen Fall eines längeren Ausfalls erhalten zahlende Kunden automatisch Servicegutschriften gemäß den Bedingungen unseres SLA.

Question 37

Welches Format verwendet die API-Antwort?

Accepted Answer

Unsere API liefert Antworten standardmäßig im JSON-Format, das von allen modernen Programmiersprachen unterstützt wird. Jede Antwort enthält den abgefragten Namen, das erkannte Geschlecht, einen Genauigkeits- bzw. Wahrscheinlichkeitswert und zusätzliche Metadaten. Zum Beispiel: {"name":"Maria","gender":"female","accuracy":99,"samples":12847,"country":"US"}. Ausführliche Antwortschemata findest du in unserer API-Dokumentation, und du kannst unsere OpenAPI-Spezifikation für die automatische Client-Generierung herunterladen.

Question 38

Wie sollte ich mit API-Fehlern umgehen?

Accepted Answer

Unsere API verwendet die üblichen HTTP-Statuscodes, um Erfolg oder Fehler anzuzeigen. 200 bedeutet Erfolg, 401 einen ungültigen API-Schlüssel, 429 ein überschrittenes Rate-Limit und 500 einen Serverfehler. Jede Fehlerantwort enthält eine sprechende Meldung und einen Fehlercode, damit du schnell nachvollziehen kannst, was passiert ist. Wir empfehlen, bei Rate-Limit-Fehlern ein exponentielles Backoff zu implementieren und erfolgreiche Antworten nach Möglichkeit zu cachen. Bei anhaltenden Fehlern schau in unsere API-Dokumentation oder kontaktiere den Support. Alle Fehler werden zur Fehlersuche protokolliert.

Question 39

Wie handhabt ihr die Versionierung der API?

Accepted Answer

Wir betreiben derzeit zwei API-Versionen: V1 und V2. V2 ist unsere neueste Version mit erweiterten Funktionen, darunter Wahrscheinlichkeitswerte, erweiterte Länderunterstützung und verbesserte Genauigkeit. V1 bleibt aus Gründen der Abwärtskompatibilität verfügbar, aber wir empfehlen dir, für neue Integrationen auf V2 umzusteigen. Alle API-Endpunkte enthalten die Versionsnummer im URL-Pfad (z. B. /v2/name). Wir garantieren, dass ältere API-Versionen weiterhin funktionieren. Migrationsanleitungen findest du in unserer API-Dokumentation. Inkompatible Änderungen werden immer frühzeitig angekündigt.

Question 40

Wie geht ihr mit Namensvarianten und Spitznamen um?

Accepted Answer

Unsere Datenbank enthält gängige Namensvarianten, Koseformen und Spitznamen. Zum Beispiel wird „Bob“ als Variante von „Robert“ erkannt und „Liz“ als Variante von „Elizabeth“. Wir empfehlen aber, möglichst den vollständigen Vornamen abzufragen, um die beste Genauigkeit zu erreichen. Unsere KI-Systeme lernen kontinuierlich neue Namensvarianten aus unserem Datenbestand. Wenn du auf einen Spitznamen stößt, der nicht erkannt wird, sag uns Bescheid, und wir nehmen ihn in unsere Datenbank auf. Regionale Varianten (etwa „Juan“ und „John“) deckt unser länderspezifischer Datenbestand ab.

Question 41

Unterstützt die API Namen mit Sonderzeichen und Akzenten?

Accepted Answer

Ja! Unsere API unterstützt Unicode-Zeichen vollständig, einschließlich Akzentbuchstaben (é, ñ, ü), Umlauten, diakritischen Zeichen und nicht-lateinischen Schriften (Arabisch, Kyrillisch, Chinesisch usw.). Namen sollten in deinen API-Anfragen UTF-8-codiert sein. „François“, „José“, „Müller“ und „Søren“ werden zum Beispiel alle korrekt verarbeitet. Die URL-Codierung übernehmen die meisten HTTP-Clients automatisch, achte aber auf die korrekte Codierung von Sonderzeichen. Unsere Datenbank enthält Namen aus 191 Ländern und deckt alle wichtigen Schriftsysteme ab. Mehr Details findest du in unserer API-Dokumentation.

Question 42

Welche Datenquellen nutzt ihr?

Accepted Answer

Wir kombinieren mehrere verlässliche Datenquellen, um eine möglichst hohe Genauigkeit zu erreichen. Dazu gehören: Volkszählungsdaten und Geburtsregister zahlreicher Länder, öffentlich verfügbare Namensdatenbanken, anonymisierte und DSGVO-konforme Daten aus sozialen und beruflichen Netzwerken, historische Namensregister sowie manuelle Prüfungen durch unser Datenteam.

Alle Datenquellen werden sorgfältig geprüft und miteinander abgeglichen. Wo verfügbar, haben offizielle staatliche Quellen Vorrang. Unsere KI-Modelle helfen außerdem, Muster zu erkennen und die Konsistenz über alle Quellen hinweg zu prüfen. Eine vollständige Liste der unterstützten Länder findest du hier.

Wir aktualisieren unsere Datenbank regelmäßig, sobald neue offizielle Daten verfügbar sind.

Question 43

Wie stellt ihr Datenschutz und Privatsphäre sicher?

Accepted Answer

Wir nehmen Datenschutz sehr ernst und halten uns an die DSGVO, den CCPA und weitere internationale Datenschutzvorschriften. Die von dir abgefragten Namen speichern wir nur so lange, wie es das für den Betrieb notwendige Logging erfordert. Die gesamte API-Kommunikation ist per HTTPS/TLS verschlüsselt. Für Unternehmenskunden bieten wir Auftragsverarbeitungsverträge an. Deine hochgeladenen CSV- und Excel-Dateien werden nach einem Jahr automatisch gelöscht. Wir verkaufen Kundendaten nie und geben sie nicht an Dritte weiter. Unsere Server stehen in sicheren europäischen Rechenzentren. Alle Details findest du in unserer vollständigen Datenschutzerklärung. Regelmäßige Sicherheitsprüfungen stellen die fortlaufende Compliance sicher.

Question 44

Kann ich Rechnungen und Belege für meine Zahlungen bekommen?

Accepted Answer

Ja, für alle Käufe werden automatisch Rechnungen erstellt, die in deinem Konto-Dashboard bereitstehen. Du kannst PDF-Rechnungen jederzeit herunterladen; sie werden außerdem an deine registrierte E-Mail-Adresse gesendet. Die Rechnungen enthalten alle für die Buchhaltung notwendigen Angaben, inklusive Mehrwertsteuer, sofern zutreffend. Du kannst deine Rechnungs- und Firmendaten jederzeit aktualisieren, damit die Rechnungen die richtigen Angaben enthalten. Für ältere Rechnungen oder besondere Rechnungsanforderungen kontaktiere unseren Support.

Question 45

Wie sieht eure Rückerstattungsrichtlinie aus?

Accepted Answer

Wir bieten dir eine unkomplizierte 14-tägige Geld-zurück-Garantie für Erstkäufe. Wenn unser Service deine Erwartungen in den ersten 14 Tagen nicht erfüllt, kontaktiere uns für eine vollständige Rückerstattung — ohne Wenn und Aber.

Bei Abonnements kannst du jederzeit kündigen, um zukünftige Zahlungen zu stoppen. Ungenutzte Credits aus Einmalkäufen bleiben ein Jahr lang gültig. In Einzelfällen erstatten wir auch bei technischen Problemen oder Störungen des Dienstes.

Alle Details findest du in unserer vollständigen Widerrufsbelehrung, oder kontaktiere den Support, wenn du Fragen hast.

Question 46

Welche Drittanbieter-Integrationen sind verfügbar?

Accepted Answer

Wir bieten Integrationen für verbreitete Plattformen und Tools, darunter Zapier, Make (früher Integromat), Google Sheets, Microsoft Excel, Salesforce, HubSpot und viele CRM-Systeme. Unsere API funktioniert mit jeder Plattform, die REST-APIs oder Webhooks unterstützt. Wir stellen einsatzbereite Connectoren und ausführliche Integrationsanleitungen für die großen Plattformen bereit. Für eine einmalige Datenverarbeitung ohne jede Integration kannst du auch unseren CSV-Upload nutzen. Für individuelle Integrationen oder Unterstützung zu bestimmten Plattformen schau in unsere Dokumentation oder kontaktiere den Support.

HÄUFIG GESTELLTE FRAGEN