Post
Benötigtes Guthaben: 2
| URL |
https://gender-api.io/v2/country-of-origin
|
| Headers |
Content-Type: application/json
|
| JSON Payload |
| Feld |
Typ |
Benötigt |
Beschreibung |
| first_name |
string |
Ja |
Vorname der abgefragt werden soll |
| full_name |
string |
Nein |
Abzufragender vollständiger Name. Kann alternativ zum first_name Feld gesendet werden |
| email |
string |
Nein |
Abzufragende E-Mail Adresse. Kann alternativ zum first_name Feld gesendet werden |
| 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 nur mit einem Vornamen
{"first_name":"Johann"}
Abfrage eines vollständigen Namens
{"full_name":"Theresa Miller"}
Abfrage anhand einer E-Mail Adresse
{"full_name":"sophia5342@gmail.com"}
Antwort
{
"input": {
"first_name": "Johann",
"id": 12
},
"details": {
"credits_used": 2,
"duration": "414ms",
"samples": 890,
"country": null,
"first_name_sanitized": "johann"
},
"result_found": true,
"country_of_origin": [
{
"country_name": "Germany",
"country": "DE",
"probability": 0.52,
"continental_region": "Europe",
"statistical_region": "Western Europe"
},
{
"country_name": "Austria",
"country": "AT",
"probability": 0.48,
"continental_region": "Europe",
"statistical_region": "Western Europe"
}
],
"first_name": "Johann",
"probability": 0.9,
"gender": "male",
"language_of_origin": "Germanic",
"meaning": "Johann is the German variation of the name John, which means 'God is gracious'. It was frequently used in the Middle Ages across Europe, particularly as a name for religious figures.",
"ethnicity": {
"id": "GERMANIC",
"name": "Germanic (German, Austrian, Swiss)",
"distribution": [
{
"id": "GERMANIC",
"name": "Germanic (German, Austrian, Swiss)",
"percentage": 90
},
{
"id": "DUTCH",
"name": "Dutch",
"percentage": 5
},
{
"id": "FRENCH",
"name": "French",
"percentage": 5
}
]
}
}
| 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 |
| country_of_origin_map_url |
string |
URL zu einer interaktiven Karte zu diesem Namen |
| 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 |
| country_of_origin |
object |
Top 25 Herkunftsländer. Sieh dir "Vollständige Liste mögliche Namen" für eine Liste der unterstützten Länder an. Jeder Eintrag enthält die Felder country_name, country, probability, continental_region und statistical_region |
| language_of_origin |
string |
Die Ursprungssprache dieses Namens |
| meaning |
string |
Eine kurze Beschreibung der Bedeutung dieses Namens |
| ethnicity |
object |
Das Feld „Ethnizität“ liefert Informationen über die primäre ethnische Gruppe, die mit dem Namen verbunden ist, sowie über die Verteilung des Namens auf verschiedene ethnische Gruppen |
| ethnicity.id |
string |
Das Feld "id" enthält einen Identifikator für die bestimmte Hauptethnie. Sieh dir "Vollständige Liste der möglichen ethnischen Gruppen" für eine vollständige Liste der möglichen ethnischen Gruppen an |
| ethnicity.name |
string |
Das Namensfeld enthält den Namen der bestimmten Haupethnischen Gruppe. Sieh dir die "Vollständige Liste der möglichen ethnischen Gruppen" für eine vollständige Liste der möglichen ethnischen Gruppen an |
| ethnicity.distribution |
array |
Das Feld "Verteilung" enthält Informationen über den Anteil des Namens innerhalb verschiedener ethnischer Gruppen. Jeder Eintrag im Array enthält die Felder id (string), name (string) und prozentualer Anteil (float). Siehe "Vollständige Liste möglicher ethnischer Gruppen" für eine vollständige Liste der möglichen Werte |