Determinar el género a partir de hasta 50 direcciones de correo electrónico

Resumen de solicitud en masa

Procesar hasta 50 direcciones de correo electrónico

Enviar undataarray. GenderAPI extrae un nombre probable de cada dirección y devuelve la predicción correspondiente; tu opciónidhace que la correlación con la base de datos sea determinística.

MethodPOST

Maximum50 correos electrónicos

Authenticationtoken Bearer

Formato de resultadonames[]

50 correos electrónicos maxExtracción de nombreResultados conscientes del país

HDR

Encabezados HTTP requeridos

Autorizar la solicitud en lote

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Cuerpo de solicitud en formato JSON

Parámetros

Field	Type	Requirement	Description
`data`	object[]	Requerido	Array que contiene entre 1 y 50 registros de correo electrónico.
`data[].email`	string	Requerido	Dirección de correo electrónico desde la cual GenderAPI extrae un nombre propio probable.
`data[].country`	string	Opcional	Código alfa-2 de ISO 3166-1 utilizado como contexto regional.
`data[].id`	string \| integer	Opcional	Su identificador de registro, devuelto sin cambios junto con el resultado correspondiente.

Coincidencia de registro

Utilice un únicoidPara cada elemento. GenderAPI lo devuelve junto con el resultado correspondiente al elemento, permitiéndote actualizar el registro de la base de datos correcto sin depender únicamente de la posición del array.

Carga del cuerpo de la solicitud

Construir el array de correos electrónicos

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" }
  ]
}

Ejemplos de código

Enviar una solicitud con múltiples correos electrónicos

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 })
});

Respuesta con código 200

Nombres extraídos y predicciones

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"
}

Campos de la respuesta

Field	Type	Description
`status`	boolean	Si la solicitud en masa se completó exitosamente.
`used_credits`	integer	Créditos consumidos en todos los correos electrónicos enviados.
`remaining_credits`	integer	Créditos disponibles después de la solicitud.
`expires`	integer	Tiempo de expiración del paquete como marca de tiempo UNIX.
`names`	object[]	Colección ordenada de resultados para los correos electrónicos enviados.
`names[].name`	string	Nombre de pila extraído del direccional electrónico.
`names[].q`	string	Correo electrónico original enviado en la solicitud.
`names[].gender`	string \| null	Valor predicho: masculino, femenino o nulo.
`names[].country`	string	Código de país considerado para este resultado.
`names[].total_names`	integer	Número de muestras que apoyan este resultado.
`names[].probability`	integer	Confianza de predicción en porcentaje.
`names[].id`	string \| integer	Identificador de entrada devuelto para correlación del registro.
`duration`	string	Tiempo total de procesamiento del servidor.

Mantener cada solicitud dentro de 50 registros

Validar cada dirección y dividir los conjuntos de datos más grandes en lotes de no más de 50. Verificar la extracciónname and probabilityantes de aplicar un resultado.

Guía siguiente

Determinar el género a partir de un nombre de usuario

Solicitud individual de nombre de usuarioExtraer un nombre a partir de un nombre de usuario →Solicitud individual de correo electrónicoUsar el respaldo de IA para un correo electrónico →