Determinare il genere da fino a 50 indirizzi email

Panoramica della richiesta bulk

Elabora fino a 50 indirizzi email

Invia undataarray. GenderAPI estrae un nome probabile da ogni indirizzo e restituisce la previsione corrispondente; il tuo opzionaleidrende la correlazione con il database deterministica.

MethodPOST

Maximum50 email

Authenticationtoken Bearer

Formato del risultatonames[]

50 email maxEstrazione del nomeRisultati consapevoli del paese

HDR

Intestazioni HTTP richieste

Autorizzare la richiesta in bulk

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Corpo della richiesta in formato JSON

Parametri

Field	Type	Requirement	Description
`data`	object[]	Obbligatorio	Array contenente da 1 a 50 record di email.
`data[].email`	string	Obbligatorio	Indirizzo email dal quale GenderAPI estrae un nome probabilmente di primo uso.
`data[].country`	string	Opzionale	Codice alpha-2 ISO 3166-1 utilizzato come contesto regionale.
`data[].id`	string \| integer	Opzionale	Il tuo identificativo del record, restituito senza modifiche insieme al risultato corrispondente.

Corrispondenza del record

Utilizzare un valore unicoidPer ogni elemento. GenderAPI lo restituisce insieme al risultato dell'elemento, consentendoti di aggiornare il record del database corretto senza dipendere unicamente dalla posizione nell'array.

Corpo della richiesta

Costruire l'array dell'email

JSON

{
  "data": [
    { "email": "andrea.schmidt@example.com", "country": "DE", "id": "123" },
    { "email": "andrea.rossi@example.it", "country": "IT", "id": "456" },
    { "email": "james.brown@example.com", "country": "US", "id": "789" }
  ]
}

Esempi di codice

Invia una richiesta con più indirizzi email

cURL

curl -X POST "https://api.genderapi.io/api/email/multi/country" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"data":[{"email":"andrea.schmidt@example.com","country":"DE","id":"123"},{"email":"james.brown@example.com","country":"US","id":"789"}]}'

JavaScript

const data = [
  { email: "andrea.schmidt@example.com", country: "DE", id: "123" },
  { email: "james.brown@example.com", country: "US", id: "789" }
];
const response = await fetch("https://api.genderapi.io/api/email/multi/country", {
  method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ data })
});

Risposta 200

Nomi estratti e predizioni

JSON

{
  "status": true, "used_credits": 3, "remaining_credits": 7265,
  "expires": 1717069765,
  "names": [
    { "name": "Andrea", "q": "andrea.schmidt@example.com", "gender": "female", "country": "DE", "total_names": 644, "probability": 88, "id": "123" },
    { "name": "James", "q": "james.brown@example.com", "gender": "male", "country": "US", "total_names": 45274, "probability": 100, "id": "789" }
  ], "duration": "5ms"
}

Campi della risposta

Field	Type	Description
`status`	boolean	Se la richiesta in bulk è stata completata con successo.
`used_credits`	integer	Crediti consumati in tutte le email inviate.
`remaining_credits`	integer	Crediti disponibili dopo la richiesta.
`expires`	integer	Scadenza del pacchetto come timestamp UNIX.
`names`	object[]	Collezione ordinata dei risultati per le email inviate.
`names[].name`	string	Nome di primo livello estratto dall'indirizzo email.
`names[].q`	string	Email originale inviata nella richiesta.
`names[].gender`	string \| null	Valore previsto: maschio, femminile o null.
`names[].country`	string	Codice nazionale considerato per questo risultato.
`names[].total_names`	integer	Numero di campioni che supportano questo risultato.
`names[].probability`	integer	Confidenza della previsione espressa in percentuale.
`names[].id`	string \| integer	Identificatore di input restituito per la correlazione del record.
`duration`	string	Tempo totale di elaborazione del server.

Mantenere ogni richiesta entro 50 record

Validare ogni indirizzo e dividere i dati più grandi in batch di al massimo 50. Verificare l'estrazionename and probabilityprima di applicare il risultato.

Guida successiva

Determinare il genere da un nome utente

Richiesta singola per nome utenteEstrarre un nome da un nome utente →Richiesta singola per emailUtilizzare il fallback AI per un'email →