API Dokumentation Unified API
Abfrage anhand einer E-Mail Adresse
Du kannst unsere Datenbank auch nach E-Mail Adressen abfragen, die einen Vornamen enthalten:
Post
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>
|
||||||||||||||||||||||||
JSON Payload |
|
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": "Sandra"
},
"details": {
"credits_used": 1,
"samples": 464,
"country": null,
"email_sanitized": "sandra",
"duration": "436ms"
},
"result_found": true,
"email": "Sandra",
"probability": 0.85,
"gender": "female"
}
Feld | Typ | Beschreibung |
---|---|---|
input | array | Der übergebene Input |
details.credits_used | int | Die Anzahl an Credits, 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 | int | 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 |
string | Die e-Mail-Adresse, die wir für die Bestimmung des Geschlechts verwendet haben | |
probability | string | 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 |
Dieses Produkt enthält GeoLite2 Daten erstellt von MaxMind, verfügbar von http://www.maxmind.com.