API Dokumentation Unified API v2.0
API v1.0
Abfrage nur mit einem Vornamen
Das ist der einfachste Weg, das Geschlecht zu bestimmen. Alle Antworten unseres Servers sind im JSON Format:
URL |
https://gender-api.com/v2/gender
|
||||||||||||||||||||||||
Headers |
Content-Type: application/json
Authorization: Bearer <dein Authentifizierungstoken>
|
||||||||||||||||||||||||
JSON Payload |
|
Beispiele
{"first_name":"Sandra"}
{"first_name":"Sandra","country":"US"}
{"first_name":"Sandra","locale":"en_US"}
{"first_name":"Sandra","ip":"54.201.16.177"}
[{"first_name":"Sandra","country":"US"},{"first_name":"Jason","country":"US"}]
{
"input": {
"first_name": "Sandra"
},
"details": {
"credits_used": 1,
"samples": 464,
"country": null,
"first_name_sanitized": "sandra",
"duration": "436ms"
},
"result_found": true,
"first_name": "Sandra",
"probability": 0.85,
"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.first_name_sanitized | string | 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 |
first_name | string | Der gefundene Vorname, den wir zur Bestimmung des Geschlechts genutzt 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 |