API genere da email: documentazione richiesta singola

Panoramica della richiesta

Dall’indirizzo email alla previsione

GenderAPI analizza la parte locale dell’indirizzo, estrae il nome proprio più probabile e lo usa per la previsione. Indica il paese quando conosci l’area geografica dell’utente.

01Email in ingressomichael.smith@example.com

02Estrazione del nomeMichael

03Previsionemale · 97%

MetodoPOST

Tipo di contenutoapplication/json

AutenticazioneToken Bearer

Costo1 credito

HDR

Header HTTP obbligatori

Autorizza la richiesta

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Corpo JSON della richiesta

Parametri

Parametro	Tipo	Requisito	Descrizione
`email`	string	Obbligatorio	Indirizzo email da analizzare. GenderAPI estrae il nome proprio più probabile prima di effettuare la previsione.
`country`	string	Facoltativo	Codice paese ISO 3166-1 alpha-2, come IT o US, per aggiungere il contesto geografico.
`askToAI`	boolean	Facoltativo	Se impostato su true, usa il fallback AI quando il nome estratto non produce risultati nel database.

Fallback AI

askToAI viene valutato dopo l’estrazione e solo se il nome ricavato non è presente nel database. L’endpoint email non accetta forceToGenderize.

Esempi di codice

Invia una richiesta email

cURL

curl -X POST "https://api.genderapi.io/api/email" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"email":"michael.smith@example.com","country":"IT","askToAI":true}'

JavaScript

const response = await fetch("https://api.genderapi.io/api/email", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ email: "michael.smith@example.com", country: "IT", askToAI: true })
});
const data = await response.json();

Python

import requests

response = requests.post(
  "https://api.genderapi.io/api/email",
  headers={"Authorization": "Bearer YOUR_API_KEY"},
  json={"email": "michael.smith@example.com", "country": "IT", "askToAI": True}
)
print(response.json())

Risposta 200

Nome estratto e previsione

JSON

{
  "status": true,
  "used_credits": 1,
  "remaining_credits": 4999,
  "expires": 1743659200,
  "q": "michael.smith@example.com",
  "name": "Michael",
  "gender": "male",
  "country": "IT",
  "total_names": 10345,
  "probability": 97,
  "duration": "5ms"
}

Campi della risposta

Campo	Tipo	Descrizione
`status`	boolean	Indica se la richiesta è stata completata correttamente.
`used_credits`	integer	Crediti consumati dalla richiesta.
`remaining_credits`	integer	Crediti disponibili dopo la richiesta.
`expires`	integer	Scadenza del pacchetto come timestamp UNIX.
`q`	string	Indirizzo email originale inviato nella richiesta.
`name`	string	Nome proprio estratto dall’indirizzo email.
`gender`	string \| null	Valore previsto: male, female oppure null.
`country`	string	Codice paese considerato per la previsione.
`total_names`	integer	Numero di campioni alla base della previsione.
`probability`	integer	Attendibilità della previsione espressa in percentuale.
`duration`	string	Tempo di elaborazione sul server.

Usa un indirizzo email valido e completo

L’estrazione dipende dalla struttura dell’indirizzo. Caselle generiche, alias o parti locali senza un nome riconoscibile potrebbero non produrre risultati: controlla name, gender e probability prima di utilizzare la previsione.

Guida successiva

Analizza più indirizzi email

Richiesta email multiplaElabora più indirizzi con una sola richiesta →Richiesta nome singolaInvia direttamente un nome proprio noto →