API Dokumentation Unified API v2.0
API v1.0
Abfrage eines vollständigen Namens - 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:
URL |
https://gender-api.com/v2/gender
|
||||||||||||||||||||||||
Headers |
Content-Type: application/json
Authorization: Bearer <dein Authentifizierungstoken>
|
||||||||||||||||||||||||
JSON Payload |
|
Beispiele
{"full_name":"Theresa Miller"}
{"full_name":"Theresa Miller","country":"US"}
{"full_name":"Thomas Johnson","locale":"en_US"}
{"full_name":"Markus Stefan NonExistingLastName","ip":"54.201.16.177"}
[{"full_name":"Theresa Miller"},{"full_name":"Thomas Johnson","country":"US"}]
{
"input": {
"full_name": "Theresa Miller"
},
"details": {
"credits_used": 1,
"duration": "33ms",
"samples": 8961,
"country": null,
"first_name_sanitized": "theresa"
},
"result_found": true,
"last_name": "Miller",
"first_name": "Theresa",
"probability": 0.98,
"gender": "female"
}
Feld | Typ | Beschreibung |
---|---|---|
input | object | Der übergebene Input |
details.credits_used | int | Die Anzahl an Anfragen, die für diesen Query nötig waren |
details.samples | int | Anzahl an Einträgen die auf deine Anfrage in unserer Datenbank gefunden wurden |
details.country | string | Das gefundene Land |
details.full_name_sanitized | int | Der Name, nachdem wir ihn normalisiert haben |
details.duration | string | Zeit, wie lange der Server gebraucht hat, um die Antwort zu ermitteln |
result_found | bool | True, wenn wir ein Geschlecht zum angegebenen Namen bestimmen konnten |
full_name | string | Der vollständige Name, den wir für die Bestimmung des Geschlechts verwendet haben |
probability | float | Dieser Wert (zwischen 0 und 1) bestimmt, wie sicher wir uns sind, das richtige Geschlecht gefunden zu haben. Ein Wert von 1 sagt aus, dass wir uns zu 100% sicher sind. |
gender | string | Mögliche Antworten: male, female, uknown |