Post
Benötigtes Guthaben: 1 Credit für jede erfolgreiche Anfrage
| URL |
https://gender-api.com/v2/gender
|
| Headers |
Content-Type: application/json
|
| JSON Payload |
| Feld |
Typ |
Benötigt |
Beschreibung |
| email |
string |
Ja |
Zu abfragende E-Mail-Adresse |
| 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
Abfrage anhand einer E-Mail Adresse
{"email":"theresa.miller14@gmail.com"}
Abfrage anhand einer E-Mail Adresse und eines Ländercodes
{"email":"thomas.clarks@hotmail.com","country":"US"}
Abfrage anhand einer E-Mail Adresse und benutze die Browser Locale zur Lokalisierung
{"email":"Thomas.j32@live.com","locale":"en_US"}
Abfrage anhand einer E-Mail Adresse und benutze eine IP Adresse zur Lokalisierung
{"email":"thomasfromnewyork@gmail.com","ip":"54.201.16.177"}
Abfrage mehrere Namen in einem einzigen Query
[{"email":"thomas.clarks@hotmail.com","country":"US"},{"email":"theresa.miller14@gmail.com"}]
Antwort
{
"input": {
"email": "theresa.miller14@gmail.com"
},
"details": {
"credits_used": 1,
"duration": "12ms",
"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.email_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 |
| email |
string |
Die e-Mail-Adresse, die 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 |