API Dokumentation Unified API v2.0

Benötigtes Guthaben: 1 Credit für jede erfolgreiche Anfrage

URL	https://gender-api.com/v2/gender
Headers	Content-Type: application/json Authorization: Bearer <dein Authentifizierungstoken> link
JSON Payload	Feld Typ Benötigt Beschreibung full_name string Ja Name der abgefragt werden soll country string Nein ISO 3166 ALPHA-2 Länderkürzel link locale string Nein Browser Locale ip string Nein Gültige IPv4 oder IPv6 Adresse id string Nein Max. 50 Zeichen. Du kannst diesem Feld einen beliebigen Alphanumerischen Wert mitgeben. Beispielsweise kann als ID die interne ID des Datensatzes aus deiner Datenbank gesetzt werden. In einer asynchronen Umgebung kann dadurch z.B. unsere Serverantwort besser der vorhergehenden Anfrage zugeordnet werden

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