BLOG

Während der letzten Monate haben wir in 3 Schritten das Backend unserer E-Mail-Schnittstelle komplett überarbeitet. Mit der neuen Schnittstelle ist es jetzt möglich, auch E-Mail-Adressen ohne einen erkennbaren Trenner des Vor- und Nachnamens aufzulösen. Bisher mussten Namen noch zum Beispiel mit einem Punkt oder Bindestrich getrennt sein, um korrekt in ihre Bestandteile zerlegt zu werden. Mit dem verbesserten Backend können jetzt auch E-Mail-Adressen wie kathleenevans44@gmail.com aufgelöst werden. Dazu haben wir einen mehrstufigen Prozess implementiert: Mit Machine Learning wird die Häufigkeit der möglichen Vor- und Nachnamen-Kombinationen überprüft, um für jede Möglichkeit das bestmögliche Ergebnis zu liefern. Unsere internen Tests und Analysen haben ergeben, dass wir so die Qualität der Ergebnisse um mehr als 30% verbessern konnten.

GET https://gender-api.com/get?email=kathleenevans44@gmail.com&key=<your private server key>

The request will be returned as:

{"email":"kathleenevans44@gmail.com","lastname":"evans","mailprovider":"gmail","name":"kathleen","gender":"female","samples":533,"accuracy":99,"duration":"211ms"}

Nach einem Jahr der Prüfung, ließen unsere Split API seine Beta-Stadium. Die API wurde ständig verbessert, seit wir vor einem Jahr Kunden startete sie mit einigen unserer größten. Die API kann vollständige Namen aufgeteilt (Vor- und Nachnamen) in seine Teile. Wenn Sie ein kombiniertes Feld für Vor- und Nachnamen auf Ihrer Seite haben, verwenden Sie diese API, um die Teile zu extrahieren:

 GET https://gender-api.com/get?split=theresa%20miller&key=<your private server key> 

Die Anfrage wird zurückgegeben, wie:

 {"last_name":"Miller","first_name":"Theresa","strict":false,"name":"theresa","gender":"female","samples":8065,"accuracy":98,"duration":"56ms"} 

Wir haben Support für Excel Dateien hinzugefügt. Lade eine beliebige CSV oder Excel Datei hoch, die mindestens eine Spalte mit Vornamen enthält. Für bessere Ergebnisse für zusätzlich noch eine Spalte mit dem Herkunftsland hinzu. Es ist nicht nötig, die Spalten vorab speziell zu benennen. Unser Assistent begleitet dich durch den Vorgang und lässt dich die Spalten einzeln wählen.

Wir starteten im September, Statistiken über die Nutzung der API zu sammeln. Dadurch ist es uns möglich, dir eine monatliche Übersicht deiner Nutzung bereit zu stellen. Um deine Statistik aufzurufen logge dich in deinen Account ein. Hier findest du eine detaillierte Historie über deine monatlich genutzten Requests und wie viele am Ende jedes Monates noch verfügbar waren.

Es ist jetzt möglich, Rechnung innerhalb eines Accounts herunter zu laden. Bis jetzt haben wir die Rechnungen nur per E-Mail versandt. Um diesen Vorgang zu vereinfachen haben wir jetzt zusätzlich innerhalb eines Accounts den Menüpunkt "Rechnungen" hinzugefügt. Hier kannst du alle Rechnungen ab diesem Datum finden.

In den letzten Wochen haben wir 400.000 neue qualifizierte Datensätze hinzugefügt. Diese enthielten unter anderem 20.000 indische Tamilnamen und wir dehnten außerdem unseren Support auf weitere Länder aus.

Es ist nur eine Frage der Zeit, bis IPv6 IPv4 ablösen wird. Gender-API.com unterstützt von nun an nativen IPv6 Zugriff auf unseren Dienst. Sie brauchen dafür nichts extra unternehmen, wenn Ihr ISP IPv6 unterstützt besuchen Sie unsere Seite automatisch über das neue Protokoll.

Mit unseren neuen CSV Upload Feature können Sie nun bis zu 1 Million Datensätze in einer einzigen Datei hochzuladen. Es ist nicht notwendig, dass die Spalten in der Datei spezielle Namen haben, unser Assistent lässt sie die benötigten Spalten einfach auswählen. Das CSV Upload Feature finden sie in Ihrem Account. Jeder bearbeitete Datensatz wird wie ein Request berechnet. So ist es möglich, Dateien mit bis zu 1000 Datensätzen jeden Monat kostenlos hochzuladen. Diese Beispieldatei:

 firstname;lastname
 Silvia;Miller
 Jonathan;Holmes
 Sophia;Smith

ergibt folgende Ausgangsdatei:

 firstname;lastname;ga_gender;ga_accuracy
 Silvia;Miller;female;99
 Jonathan;Holmes;male;100
 Sophia;Smith;female;98

Wir fügen immer mehr Datensätze zu unserer Datenbank hinzu. Aktuell unterstützen wir mir als 140 Länder mit über 350 000 eindeutigen Namen. Alles in allem enthält unsere Datenbank aktuell 5 347 230. Mit alleine 68 077 Namen in den USA ist dieses unser aktuell am besten unterstütztes Land,

Unsere jQuery Plugin stellt eine einfache Möglichkeit dar, unsere API in den unterschiedlichsten online Formularen zu implementieren. Das Plugin ist auf Github gehostet. Dieses Beispiel zeigt die einfachste Möglichkeit der Verwendung:

$('input#firstname').genderApi({key: genderApiClientKey}).on('gender-found', function(e, result) {
                if (result.accuracy >= 60) {
                    alert('Gender found: ' + result.gender);
                }
            });

Besuchen Sie unsere Plug Seite um mehr über dieses Plugin zu erfahren.

Wir unterstützen nun mehrere Namen pro Query. Es ist nun möglich bis zu 100 Namen in einem einzigen Request anzufragen. Mehrere Namen können einfach mit einem Strichpunkt getrennt übergeben werden:

GET https://gender-api.com/get?name=Anna;Jack;Stephen

Das Ergebnis sieht dann wie folgt aus:

{"name":"anna;jack;stephen","result":[{"name":"anna","gender":"female","samples":51142,"accuracy":98},{"name":"jack","gender":"male","samples":24890,"accuracy":97},{"name":"stephen","gender":"male","samples":26428,"accuracy":100}],"duration":"190ms"}

Da es am Markt keine kommerziell vernünftig nutzbare Lösung zur Gender Bestimmung gab, haben wir uns entschlossen, selbst eine eigene Cloud basierte Plattform zu starten. Damit ist es uns möglich sehr schnell auf unterschiedliche Anforderungen zu reagieren und ein Höchstmaß an Erreichbarkeit zu gewährleisten. Zum Start unterstützen wir bereits 140 000 unterschiedliche Namen aus 68 unterschiedlichen Ländern.