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.

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 fließend und ändern sich mit der Zeit. Auch Datensätze variieren von Kunde zu Kunde stark in Qualität, Umfang und Herkunft. Daher können wir nicht garantieren, dass alle Ergebnisse, die du von unserer API erhältst, zu 100% korrekt sind und mit deinem Datenbestand übereinstimmen. Wir können dir aber versprechen, dass wir stets bemüht sind, dir das bestmögliche Ergebnisse zu liefern und dass wir unsere Algorithmen regelmäßig verbessern und aktualisieren. Außerdem fügen wir regelmäßig neue Daten hinzu. Mehr über unsere Updates erfährst du hier. Für den unwahrscheinlichen Fall, dass unser Service nicht deinen Erwartungen entspricht, gewähren wir dir eine unkomplizierte 14-Tage-Geld-zurück-Garantie. Natürlich bieten wir dir auch an, unseren Service kostenlos zu testen. Wenn du dich hier anmeldest, erhältst du 100 Anfragen kostenlos jeden Monat. Wenn du über unsere API einen Namen abfragst, geben dir unsere Endpunkte in der Antwort entweder einen Genauigkeits- oder einen Wahrscheinlichkeitswert zurück, je nach der verwendeten API-Version. 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 für diesen Namen in unserer Datenbank berechnet. Da die Anwendungsfälle sehr unterschiedlich sind, geben wir keine Empfehlungen für den Genauigkeitsgrad. Abhängig von deinem Anwendungsfall musst du entscheiden welche Ergebnisse und Genauigkeitsstufen du akzeptierst. Selbst bei einer Genauigkeit von mindestens 99 % besteht die Möglichkeit, dass das Ergebnis falsch ist. Ein Wert von über 95 % ist jedoch für die meisten Anwendungsfälle geeignet.

Unsere Datenbank enthält 6,084,389 validierte Namen aus 191 unterschiedlichen Ländern. Über die gesamte Welt gesehen haben wir 6,195,008 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 ersten API-Schlüssel, wenn dich auf unserer Seite anmeldest. Du findest diesen API-Schlüssel unten auf der Übersichtsseite deines Kontos. Wenn du diesen Schlüssel widerrufen oder neu erstellen möchtest, klicken Sie auf die Schaltfläche "Widerrufen und neu generieren”. Unser System wird dann den bestehenden API-Schlüssel invalidieren und einen neuen Schlüssel generieren. Alle deine Anwendungen, die den alten Token verwenden, können dann nicht mehr auf unsere API zugreifen, bis du diesen Code durch den neuen API-Schlüssel ersetzt. Du kannst auch mehr als einen API-Schlüssel erstellen. Dies ist z. B. nützlich, wenn du mehrere Anwendungen hast, die unsere Schnittstelle nutzen möchten. Bitte beachte, dass es keinen Unterscheidung bei den verbrauchten Anfragen zwischen den Schlüsseln gibt. Alle Anfragen werden summiert. Um mehrere API-Schlüssel zu verwalten oder zu erstellen, klicke im Kontomenü auf die Schaltfläche "Einstellungen" und dann auf "API-Schlüssel”. Wenn du auf die Schaltfläche "Neuen Schlüssel erstellen" klickst, kannst du einen neuen API-Schlüssel erzeugen. Du kannst außerdem jedem Token einen Namen geben, um später wieder leichter erkennen zu können, wo dieser Schlüssel verwendet wird. Du kannst diesen Namen jederzeit wieder ändern. Außerdem generieren einige unserer Widgets hier automatisch einen Schlüssel. Wenn du z. B. unser "Quick Lookup Widget" in deinem Konto verwendest, generiert unser System im Vorfeld für dieses Widget einen API Schüssel, der dann von diesem Tool in Zukunft benutzt wird. Außerdem erstellen Drittanbieter-Apps hier einen Schlüssel, sobald sie mit unserer API verbunden werden. Jeder Token kann hier jederzeit widerrufen werden, indem man auf "x" klickt. Sobald der Token widerrufen wurde, 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 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.

If you need a certificate of residence from our company, please contact our support regarding your request. The certificate has to be individually requested for every company. Include in your request the full address of your company, your country of residence, and, if available, your tax number. The certificate of residence needs to be signed through our revenue office. It usually takes 2-3 weeks to receive the signed form, which we can then provide as a digital scan.

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".