Post
Richieste richieste: 2
URL |
https://gender-api.com/v2/country-of-origin
|
Headers |
Content-Type: application/json
|
JSON Payload |
Campo |
Tipo |
Richieste |
Descrizione |
first_name |
string |
Sì |
Nome da interrogare |
full_name |
string |
Sì |
Nome completo da cercare. Può essere fornito invece del campo first_name |
email |
string |
Sì |
Indirizzo email da cercare. Può essere fornito invece del campo first_name |
id |
string |
Sì |
Max 50 caratteri. Puoi impostare questo ID a qualsiasi valore alfanumerico desideri.
Ad esempio, puoi impostare l'ID al tuo ID interno del dataset nel tuo database. In un ambiente asincrono, questo può aiutarti a collegare meglio la risposta a una richiesta precedente |
|
Esempi
Interrogazione per nome
{"first_name":"Johann"}
Cerca per nome completo
{"full_name":"Theresa Miller"}
Interrogazione per indirizzo email
{"full_name":"sophia5342@gmail.com"}
Risposta
{
"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
}
]
}
}
Campo |
Tipo |
Descrizione |
input |
object |
Il payload inviato |
details.credits_used |
int |
Il numero di richieste utilizzate per questa query |
details.samples |
int |
Il numero di record trovati nel nostro database che corrispondono alla tua richiesta |
details.country |
string |
Il paese che abbiamo trovato |
details.first_name_sanitized |
string |
Il nome dopo che abbiamo applicato il nostro normalizzatore |
details.duration |
string |
Tempo necessario al server per elaborare la richiesta |
result_found |
bool |
True se siamo stati in grado di interrogare un genere per il nome dato |
country_of_origin_map_url |
string |
URL a una mappa interattiva su questo nome |
first_name |
string |
Il primo nome che abbiamo usato per la genderizzazione |
probability |
float |
Questo valore (compreso tra 0 e 1) determina l'affidabilità del nostro database. Un valore di 1 significa che i risultati sulla tua richiesta di genere sono accurati al 100% |
gender |
string |
Valori possibili: maschio, femmina, sconosciuto |
country_of_origin |
object |
I primi 25 paesi di origine. Vedi "Elenco Completo Dei Possibili Paesi" per un elenco dei paesi supportati. Ogni record contiene i campi country_name, country, probability, continental_region e statistical_region |
language_of_origin |
string |
La lingua d'origine di questo nome |
meaning |
string |
Una breve descrizione del significato di questo nome |
ethnicity |
object |
Il campo etnia fornisce dettagli sul principale gruppo etnico associato al nome, così come la distribuzione del nome tra vari gruppi etnici |
ethnicity.id |
string |
Il campo id contiene un identificatore per il gruppo etnico principale determinato. Vedi "Elenco Completo Dei Possibili Gruppi Etnici" per un elenco completo dei possibili gruppi etnici |
ethnicity.name |
string |
Il campo del nome contiene il nome del gruppo etnico principale determinato. Consulta "Elenco Completo dei Gruppi Etnici Possibili" per un elenco completo dei gruppi etnici possibili |
ethnicity.distribution |
array |
Il campo Distribuzione contiene informazioni sulla proporzione del nome all'interno dei diversi gruppi etnici. Ogni voce dell'array contiene i campi id (string), nome (string) e percentuale (float). Vedi "Elenco Completo Dei Possibili Gruppi Etnici" per un elenco completo dei valori possibili |