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:
Benötigtes Guthaben: 1 Credit für jede erfolgreiche Anfrage
Anfrage
Ohne Länder Code
GET https://gender-api.com/get?split=theresa%20miller&key=<Dein API Schlüssel>Anfrage
Mit Länder Code
GET https://gender-api.com/get?split=tim%20johnson&country=US&key=<Dein API Schlüssel>Anfrage
"Strict mode" aktiviert
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 |
Antwort
Ohne Länder Code
{"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}Antwort
Mit Länder Code
{"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}Antwort
"Strict mode" aktiviert
{"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.
