⚡ API Unificata v2.0
AVANZATO
API DOCUMENTATION
Prova la nostra API unificata ad alte prestazioni, progettata per utenti avanzati con alti volumi di richieste. Interroga più nomi in una singola richiesta con tempi di risposta fulminei.
Interrogazione per indirizzo email
Puoi anche interrogare il genere utilizzando un indirizzo email contenente un indirizzo email:
POST https://gender-api.com/v2/gender
Richieste richieste: 1
| Headers |
Content-Type: application/json
Authorization: Bearer <token di autorizzazione>
|
||||||||||||||||||||||||
| JSON Payload |
|
Request Examples
Interrogazione solo per indirizzo email
Try Live On Codepen.io
{
"email": "theresa.miller14@gmail.com"
}
Query per indirizzo email e codice paese
Try Live On Codepen.io
{
"email": "thomas.clarks@hotmail.com",
"country": "US"
}
Interrogazione per indirizzo e-mail e lingua del browser
Try Live On Codepen.io
{
"email": "Thomas.j32@live.com",
"locale": "en_US"
}
Interrogare tramite indirizzo email e utilizzare un indirizzo IP per la localizzazione
Try Live On Codepen.io
{
"email": "thomasfromnewyork@gmail.com",
"ip": "54.201.16.177"
}
Richiedi più nomi in un'unica richiesta
Try Live On Codepen.io
[
{
"email": "thomas.clarks@hotmail.com",
"country": "US"
},
{
"email": "theresa.miller14@gmail.com"
}
]
Risposta
{
"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"
}
Campi della risposta
| 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.email_sanitized |
int | 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 |
email |
string | L'indirizzo e-mail che abbiamo utilizzato per la determinazione del genere |
probability |
float | Questo valore (compreso tra 0 e 1) determina l'affidabilità del nostro database. Un valore di 1 significa che i risultati sulla richiesta di genere sono accurati al 100%. |
gender |
string | Valori possibili: maschio, femmina, sconosciuto |