API DOCS
VOR- UND NACHNAME SPLITTEN
Wenn du ein kombiniertes Feld für Vor- und Nachname auf deiner Webseite hast, benutze diesen API Endpunkt um die entsprechenden Teile zu extrahieren:
GET https://gender-api.com/get?split=theresa%20miller&key=<Dein API Schlüssel>
GET https://gender-api.com/get?split=tim%20johnson&country=US&key=<Dein API Schlüssel>
GET https://gender-api.com/get?split=markus%20stefan%20nonExistingLastName&strict=true&key=<Dein API Schlüssel>
Feld | Typ | Beschreibung |
---|---|---|
split | String | Vollständiger Name |
country | String | ISO 3166 ALPHA-2 Country Code |
strict | Boolean (true|false) | Wenn der "strict mode" aktiviert ist, geben wir null im Feld last_name zurück, wenn der Nachname nicht in unserer Datenbank gefunden werden konnte. Wenn der "strict mode" deaktiviert ist, versuchen wir diesen zu erkennen, auch wenn dieser nicht in der Datenbank vorhanden ist |
key | String | Dein API Schlüssel |
{"last_name":"Miller","first_name":"Theresa","strict":false,"name":"theresa","name_sanitized":"Theresa","country":"","gender":"female","samples":70,"accuracy":74,"duration":"56ms","credits_used":1}
{"last_name":"Johnson","first_name":"Tim","strict":false,"name":"tim","name_sanitized":"Tim","country":"US","gender":"male","samples":7,"accuracy":100,"duration":"58ms","credits_used":1}
{"last_name":"","first_name":"Markus Stefan","strict":true,"name":"markus","name_sanitized":"Markus","country":"","gender":"male","samples":150,"accuracy":99,"duration":"85ms","credits_used":1}
Feld | Typ | Beschreibung |
---|---|---|
last_name | String | Der gefundene Nachname |
first_name | String | Der gefundene Vorname |
strict | Boolean | True wenn der "strict mode" aktiviert ist |
name | String | Der gefundene Vorname in Kleinschreibung |
name_sanitized | String | Der Name, nachdem wir ihn normalisiert haben |
country | String | Übergebener Ländercode |
gender | String | Mögliche Antworten: male, female, uknown |
samples | Integer | Anzahl an Einträgen die auf deine Anfrage in unserer Datenbank gefunden wurden |
accuracy | Integer | Dieser Wert bestimmt, wie sicher wir sind, das richtige Geschlecht gefunden zu haben. Ein Wert von 100 sagt aus, dass wir uns zu 100% sicher sind |
duration | String | Zeit, wie lange der Server gebraucht hat, um die Antwort zu ermitteln |
credits_used | Integer | Die Anzahl an Credits, die für diesen Query nötig waren |
Wenn möglich sollten Sie ihre Kunden darauf hinweisen, den Namen in der Form "Vorname, Nachname" einzutragen, um das Ergebnis zu verbessern.