API de Género por Email | Solicitud Individual

Resumen de la solicitud

Del email a la estimación

GenderAPI analiza la parte local de la dirección, extrae el nombre más probable y lo utiliza para estimar el género. Añade el país cuando conozcas la región de la persona.

01Email de entradamichael.smith@example.com

02Extracción del nombreMichael

03Estimaciónmale · 97%

MétodoPOST

Tipo de contenidoapplication/json

AutenticaciónToken Bearer

Coste1 consulta

HDR

Headers HTTP obligatorios

Autoriza la solicitud

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Cuerpo JSON de la solicitud

Parámetros

Parámetro	Tipo	Requisito	Descripción
`email`	string	Obligatorio	Dirección de email que se analizará. GenderAPI extrae el nombre más probable antes de realizar la estimación.
`country`	string	Opcional	Código de país ISO 3166-1 alfa-2, como ES, MX o US, para aportar contexto regional.
`askToAI`	boolean	Opcional	Cuando es true, utiliza el soporte de IA si el nombre extraído no tiene resultado en la base de datos.

Soporte de IA

askToAI se evalúa después de extraer el nombre y solo cuando ese nombre no aparece en la base de datos. El endpoint de email no admite forceToGenderize.

Ejemplos de código

Envía una solicitud por 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":"US","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: "US", 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": "US", "askToAI": True}
)
print(response.json())

Respuesta 200

Nombre extraído y estimación

JSON

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

Campos de respuesta

Campo	Tipo	Descripción
`status`	boolean	Indica si la solicitud se ha completado correctamente.
`used_credits`	integer	Créditos consumidos por la solicitud.
`remaining_credits`	integer	Créditos disponibles después de la solicitud.
`expires`	integer	Vencimiento del paquete como marca de tiempo UNIX.
`q`	string	Email original enviado en la solicitud.
`name`	string	Nombre extraído de la dirección de email.
`gender`	string \| null	Valor estimado: male, female o null.
`country`	string	Código de país considerado para la estimación.
`total_names`	integer	Número de muestras que respaldan la estimación.
`probability`	integer	Confianza de la estimación expresada en porcentaje.
`duration`	string	Tiempo de procesamiento en el servidor.

Utiliza una dirección de email válida y completa

La extracción depende de la estructura de la dirección. Los buzones genéricos, alias o partes locales sin nombres reconocibles pueden no producir un resultado. Comprueba name, gender y probability antes de utilizar la estimación. Las consultas por email no se almacenan.

Siguiente guía

Analiza varias direcciones de email

Solicitud con varios emailsProcesa varias direcciones en una solicitud →Solicitud individual por nombreEnvía directamente un nombre conocido →