FAQ - OFT GESTELLTE FRAGEN

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 Proben eines Namens haben, und 96 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 nicht einem bestimmten Geschlecht zugeordnet werden kann.

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 an, der zwischen 0 und 100 liegt (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 der API erheblich steigern, indem du eine geografische Informationen zu deiner Abfrage angibst. Dabei kann es sich entweder um einen Ländercode, das Gebietsschema des Browsers oder eine IP-Adresse handeln. Weitere Informationen zur Lokalisierung einer Abfrage findest du in unsere API-Dokumentation.

Um eine mögliche hohe Genauigkeit zu gewährleisten, kombinieren wir Daten aus verschiedenen Quellen. Die Wichtigsten sind öffentlich zugängliche Daten, Regierungsdaten und manuelle Ergänzungen/Korrekturen. Basierend auf der Quelle eines neuen Namens muss dieser ggf. noch von einer zweiten Quelle überprüft werden, bevor er unserer Liste aufgenommen wird. Wenn wir z. B. einen Namen aus öffentlich verfügbaren Daten hinzufügen, muss dieser Name möglicherweise noch durch eine zweite Überprüfung, z. B. durch einen manuellen Check, bestätigt werden, bevor er final zu unserer Datenbank hinzugefügt wird. Du findest eine Liste unterstützter Länder hier.

Wir aktualisieren unsere Daten regelmäßig, abhängig je nach Land und den verfügbaren öffentlichen Daten. Die meisten westlichen Länder werden einmal im Jahr aktualisiert. Außerdem kann sich das Verhältnis von Namen innerhalb eines Jahres ändern, wie dieser von welchem Geschlecht genutzt wird. Wenn beispielsweise ein Name in den 1970er Jahren ausschließlich von Frauen verwendet wurde, kann er Jahrzehnte später überwiegend von Männern benutzt werden. Aus diesem Grund verwenden wir auch Geburtsdaten für mehrere Länder, z.B. die USA, um die Ergebnisse damit zu verbessern. Unsere Modelle versuchen, all diese Faktoren so gut wie möglich zu berücksichtigen. 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 zum Ausdruck bringen. Wir betrachten etwa die letzten 4 Jahrzehnte an Geburtsdaten. Wenn du eine Abfrage durchführst und dieselbe Abfrage ein Jahr später wiederholst, erhältst du möglicherweise ein anderes Ergebnis, da unser System möglicherweise alte Daten gelöscht hat und neue Daten hinzugefügt wurden. Jedes Mal, wenn neue Daten hinzugefügt werden, führen wir im Anschluss daran so genannte Integrationstests durch. Dabei wird unsere API anhand eines zuvor validierten Datensatzes getestet, um die Qualität sicherzustellen. Diese Datensätze zur Qualitätskontrolle werden kontinuierlich um Namen und Testfälle erweitert, um eine möglichst breite Abdeckung zu erreichen.

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.

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

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 bieten wir auch an, unseren Service vollständig kostenlos zu testen. Wenn du dich hier anmeldest, erhältst du jeden Monat 100 Anfragen kostenfrei. Wenn du einen Namen abfragst, gibt unser Endpunkt entweder einen Genauigkeits- oder einen Wahrscheinlichkeitswert in der Antwort zurück, abhängig von deiner API-Version. Der Genauigkeitsparameter gibt an, wie sicher wir uns sind, ob dieser Name männlich oder weiblich ist. Dieser Wert wird anhand der Anzahl der Einträge in unserer Datenbank berechnet. Da sich die Anwendungsfälle erheblich unterscheiden, geben wir keine Empfehlungen für das Genauigkeitsniveau. Je nach Anwendungsfall liegt es an dir zu entscheiden, welche Ergebnisse und Genauigkeitsniveaus akzeptabel sind. Selbst bei einer Genauigkeit von mindestens 99% besteht die Möglichkeit, dass das Ergebnis falsch ist. Ein Wert über 95% passt jedoch für die meisten Anwendungsfälle im Allgemeinen

Unsere Datenbank enthält 6,084,389 validierte Namen aus 191 unterschiedlichen Ländern. Über die gesamte Welt gesehen haben wir 6,196,452 eindeutige Namen gespeichert. Im Durchschnitt analysieren wir um die 10,000,000 Millionen Datensets um unsere Qualität der Ergebnisse zu verbessern.

Voll unterstützt werde 191 Länder. Das bedeutet, dass wir für diese Länder mindestens Namen in unserer Datenbank haben. Für viele Länder haben wir aber deutlich mehr eindeutige Namen in unserer Datenbank. In folgender Tabelle finden Sie eine Übersicht, welche Länder wir mit wie vielen Namen unterstützten. Bitte beachten Sie, dass wenn wir ein für ein Land noch wenige Datensätze haben es jederzeit möglich ist, die komplette Datenbank nach diesen Namen zu durchsuchen.

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.

Ja, Sie können bis zu 100 Namen in einem Query abfragen. Details dazu finden Sie in unserer API Dokumentation.

Mit unserer E-Mail-API können Namen aus E-Mail-Adressen extrahiert werden. Anhand dieses Names liefert unser System dann die korrespondieren Informationen zur Nutzung zwischen den Geschlechtern dazu. Beispielsweise aus der E-Mail-Adresse “marie.johnson@gmail.com”, extrahieren unsere Algorithmen den Namen “Marie” und geben dir zu diesem Namen die zugehörigen Geschlechtsinformationen zurück. Mehr Infos zur Anwendung findest du in unseren API Docs. Aus Datenschutzgründen pflegen wir keine Datenbank mit E-Mail Adressen. Ein Lookup kann nur stattfinden, wenn aus der E-Mail Adresse ein Namen extrahiert werden konnte.

Als registrierter Nutzer können Sie jede beliebige CSV Dateien hochladen, welche mindestens eine Spalte mit dem Vornamen enthält. Um ein besseres Ergebnis zu erreichen, können sie optional eine Spalte mit dem Herkunftsland angeben. Es ist nicht nötig, diese Spalten speziell zu benennen, unser Assistent lässt sie die Zuordnung selbst wählen. Sie finden das CSV Upload Feature innerhalb Ihres Accounts. Verarbeitete Datenzeilen werden wie Anfragen an die API berechnet. Dadurch ist es möglich, dass sie Dateien mit bis zu 100 Zeilen pro Monat kostenlos hochladen können. Das CSV Upload Feature benötigt zwingend einen Gender-API.com Account. Aus Datenschutzgründen werden hochgeladene Dateien nach einem Jahr automatisch gelöscht.

Wir unterstützen CSV Dateien, die mit Windows, MacOS oder Linux erstellt wurden. Weiterhin unterstützen wir Dateien mit “;”, “,” oder Tab als Trennzeichen. Strings mit Leerzeichen sollten mit einem “-Zeichen umschlossen sein. Es werden außerdem auch CSV Dateien mit mehrzeiligen Datensätzen unterstützt. Es sind maximal 10,000,000 Datensätze und 301MB pro Datei möglich. Um das bestmögliche Ergebnis zu erzielen, empfehlen wir, die CSV im UTF-8 Format zu speichern. Die Datei sollte mindestens eine Spalte mit Vornamen oder eine Spalten mit einem Vor- und Nachnamen enthalten. Klicke hier um eine Beispiel-Datei herunter zu laden. Bitte erstelle einen Gender-API.com Account um eine CSV Datei hochladen zu können.

Es können Excel Dateien mit bis zu 300.000 Zeilen hochgeladen werden. Für noch größere Datensets benutze bitte unseren CSV Datei Upload. Wir unterstützen .xlsx Dateien mit einem Reiter. Wenn Ihre Excel Datei mehr als einen Reiter enthält, wird nur die erste Seite verarbeitet. Die erste Zeile in der Tabelle muss die Spaltennamen enthalten. Die Datei muss mindestens eine Spalte mit Vornamen besitzen, die Länderspalte ist optional. Aus Datenschutzgründen werden hochgeladene Dateien nach einem Jahr automatisch gelöscht. Beispieldatei hier herunterladen. Beispiel:

Wir freuen uns über jede Hilfe. Haben Sie einen Fehler gefunden, können Sie diesen unter contact gender-api.com melden. Wir werden versuchen, diesen schnellstmöglich zu beheben.

Alle Gender-API.com Dienstleistungen werden im Einklang mit der DSGVO durchgeführt. Wir stellen eine Datenverarbeitungsvereinbarung (DPA) zur Verfügung, die es ermöglicht, den DSGVO-Verpflichtungen nachzukommen. Die Vereinbarung kann in deinem Konto hier angefordert werden. Eine Mustervereinbarung kann hier heruntergeladen werden. Mehr Informationen, wie wir deine Daten schützen, findest du hier.

Wegen der Einfachheit unserer Schnittstelle bieten wir neben unserem jQuery Plugin keine Bibliotheken an. Die meisten Programmiersprachen bieten bereits einen JSON Parser bzw. gibt es eine externe Bibliothek, die dieses bereits anbietet. Bitte schauen Sie sich unsere Programmierbeispiele an, um mit der Nutzung unserer API zu beginnen:

$ composer require gender-api/client

use GenderApi\Client as GenderApiClient;

try {
    $apiClient = new GenderApiClient('insert your API key');

    // Query a single name
    $lookup = $apiClient->getByFirstName('elisabeth');
    if ($lookup->genderFound()) {
        echo $lookup->getGender();      // female
    }

    // Query a full name and improve the result by providing a country code
    $lookup = $apiClient->getByFirstNameAndLastNameAndCountry('Thomas Johnson', 'US');
    if ($lookup->genderFound()) {
        echo $lookup->getGender();      // male
        echo $lookup->getFirstName();   // Thomas
        echo $lookup->getLastName();    // Johnson
    }

} catch (GenderApi\Exception $e) {
    // Name lookup failed due to a network error or insufficient remaining requests
    // left. See https://gender-api.com/en/api-docs/error-codes
    echo 'Exception: ' . $e->getMessage();
}

Jedes Konto wird am ersten Tag jedes Monats mit 100 Anfragen aufgeladen, wenn weniger als diese Anzahl an Guthaben übrig ist. Nur wenn ein Ergebnis gefunden wird, wird die Anfrage gezählt. Ein Credit wird für jede Anfrage berechnet. Wenn mehrere Namen in einer Abfrage angefordert werden, wird jeder Name als einzelne Anfrage gezählt.

Wir generieren einen API-Schlüssel, wenn du dich für ein Gender-API.com-Konto anmeldest. Du findest diesen Schlüssel unten auf deiner Kontoseite. Wenn du diesen Schlüssel widerrufen möchtest, klicke auf den Button "Widerrufen und neu generieren". Unser System wird dann den alten API-Schlüssel ungültig machen und einen neuen generieren. Alle deine Anwendungen, die den alten Schlüssel verwenden, können unsere API dann nicht mehr zugreifen, bis du diesen Code durch den neuen API-Schlüssel ersetzt hast. Du kannst auch mehr als einen API-Schlüssel erstellen. Das ist zum Beispiel praktisch, wenn du mehrere Anwendungen hast, in denen du unsere API verwenden möchtest. 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". 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.

Du kannst innerhalb deines Accounts dein Konto mit bis zu 50 weiteren Kollegen oder anderen Personen teilen, mit denen du bei deinem Projekt zusammen arbeitest. Um dein Team zu verwalten, logge dich in dein Konto ein und klicke im Menü deines Kontos auf "Einstellungen" => "Team verwalten". Auf dieser Seite klicke dann auf die Schaltfläche "Neues Mitglied einladen", um Personen per E-Mail in dein Team einzuladen. Wenn die Mitglieder einlädst, kannst du zwischen zwei verschiedenen Kontotypen wählen. A) Benutzer können API-Schlüssel anzeigen, erstellen, aktualisieren und löschen, CSV- und Excel-Dateien hochladen, auf alle API-Endpunkte zugreifen, Anfragen kaufen und Anwendungen von Drittanbietern verbinden. B) Administratoren können die gleichen Dinge tun wie Benutzer, plus Kontoeinstellungen und Rechnungsadresse aktualisieren, Datenverarbeitungsverträge erstellen und anzeigen, Teammitglieder einladen, aktualisieren und löschen.

Du kannst dein Konto schützen, indem du die zweistufige Verifizierung aktivieren. Um diese zusätzliche Sicherheitsmaßnahme zu aktivieren, melden dich bei deinem Konto an und klicke im Menü auf "Einstellungen" => "Passwort ändern / 2FA". Stelle sicher, dass du eine Authentifizierungs-App auf deinem Telefon installiert hast. Wir empfehlen die Verwendung einer App wie Authy (App Store, Play Store) oder Google Authenticator (App Store, Play Store) Klicke dann auf die Schaltfläche "Jetzt aktivieren" und folge den Anweisungen auf dem Bildschirm. Du kannst hier mehrere Geräte hinzufügen, um z. B. sicherzustellen, dass du nach dem Verlust eines Geräts weiterhin Zugriff auf dein Konto hast. Nach der Aktivierung musst du den von der Authentifizierungs-App deines Telefons generierten Code eingeben, um dich erfolgreich anzumelden.

Einige Integrationen oder Apps von Drittanbietern funktionieren einwandfrei, wenn die Zwei-Faktor-Authentifizierung aktiviert ist, während es bei anderen erforderlich sein kann, diese Apps ohne die zweistufige Verifizierung zu verbinden. Wenn du Probleme hast, dich mit deinen Gender-API.com Zugangsdaten in eine App einzuloggen, logge dich direkt in dein Konto auf Gender-API ein und klicke auf "Einstellungen" => "Passwort ändern / 2FA" im Kontomenü. Klicke dann auf den Reiter ”Zwei-Faktor Authentifizierung und setze “Zugriff durch Drittanbieter-Apps” auf “Nicht eingeschränkt”. Bitte beachte, dass diese Einstellung nur geändert kann, wenn die Zwei-Faktor-Authentifizierung auch wirklich aktiviert ist.

Beide Kontotypen bieten die gleichen Funktionen. Es gibt keinen funktionalen Unterschied. Alle API-Endpunkte sind für beide Kontotypen verfügbar und liefern die gleichen Ergebnisse. Kostenlose Konten sind auf eine bestimmte Anzahl von Anfragen pro Monat beschränkt. Wenn du einen Account erstellst, stehen dir sofort 100 Anfragen kostenlos zur Verfügung. Am ersten Tag eines jeden Monats wird dieser Zähler von unserem System zurückgesetzt und das kostenlose Guthaben ist erneut wieder voll verfügbar. Bitte erstelle nur ein Konto. Wenn du mehr Anfragen benötigst, kannst du jederzeit hier ein Upgrade auf eines unserer kostenpflichtigen Pakete vornehmen.

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.

Wenn du eines unserer Pakete kaufen möchtest, hast du die Wahl zwischen einer einmaligen Zahlung oder dem Abonnement eines Paketes. Abonnements sind empfehlenswert, wenn du unseren Dienst regelmäßig nutzen möchtest. So kannst du sicher sein, dass immer genügend Guthaben auf deinem Konto vorhanden ist. Die mit einem Abonnement erworbenen Anfragen können innerhalb eines Monats verbraucht werden. Bei einem aktiven Abonnement lädt unser System dein Konto nach einem Monat wieder auf die gewählte Menge an Anfragen auf. Wenn du zum Beispiel unser 25.000-Anfragen-Paket abonniert hast und 21.500 verbraucht hast, lädt unser System dein Konto nach einem Monat wieder auf 25.000 Anfragen auf. Einmalige Pakete können für einen einzelnen Anwendungsfall erworben und innerhalb eines Jahres genutzt werden. Wenn du zum Beispiel eine Excel- oder CSV-Datei ein einziges mal verarbeiten möchtest, empfehlen wir den einmaligen Kauf. Einmalige Käufe verlängern sich nicht. Du musst hier selbst darauf achten, dass das Guthaben nicht aufgebraucht wird. Du kannst zwischen beiden Pakettypen auf unserer Kaufseite wechseln. [Unterschied] Bitte mische nicht beide Kaufarten, bevor du nicht mit unserem Support gesprochen hast oder genau weißt, was du tust. Wenn du ein einmaliges Paket kaufst, während du ein laufendes Abonnement besitzt, kann dies dazu führen, dass dein Abonnement deine Anfragen nicht mehr auffüllen können. Zum Beispiel, wenn mehr Anfragen vom einmaligen Kauf übrig sind, als das Abonnement wieder auffüllen würde.

Wenn Du eine Bescheinigung über den Sitz unseres Unternehmens benötigst, wende Dich bitte bezüglich Deiner Anfrage an unseren Support. Die Bescheinigung muss für jedes Unternehmen individuell angefordert werden. Füge Deiner Anfrage die vollständige Adresse Deines Unternehmens, Dein Land des Wohnsitzes und, falls verfügbar, Deine Steuernummer bei. Die Wohnsitzbescheinigung muss über unser Finanzamt unterschrieben werden. Normalerweise dauert es 2-3 Wochen, um das unterschriebene Formular zu erhalten, das wir dann als digitale Kopie bereitstellen können.

Du kannst entweder zwischen einem Abonnement oder einer Einmal-Aufladung hier wählen. Einmal-Aufladungen werden empfohlen, wenn du z.B. eine große CSV Datei hochladen willst um darin das Geschlecht zu Datensätzen zu ergänzen. Du kannst deinen Account mit der Anzahl der benötigten Anfragen jederzeit aufladen. Die bei einer Einmal-Aufladung erhaltenen Anfragen können innerhalb eines Jahres benutz werden. Wenn du dich für das Abonnement entscheidest, wird dein Account jeden Monat auf die gewählte Anzahl an Anfragen wiederaufgeladen. Abonnements können jederzeit geändert und gekündigt werden.

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