Uso básico
Haz tu primera solicitud a Gender API
Envía un valor y recibe el género estimado, la probabilidad, el país y la información de consumo. Empieza con un nombre o elige el endpoint específico para email o usuario según tus datos.
Añade tu clave API con el parámetro de consulta key. Guarda las claves de producción en el servidor; no expongas una clave privada en el navegador ni en un repositorio público.
Utiliza el contrato actual de GenderAPI en formato OpenAPI, Swagger o Postman.
Género por nombre
Nombre o nombre completo
Utiliza el endpoint principal cuando la entrada sea un nombre o un nombre completo.
https://api.genderapi.io/apicurl "https://api.genderapi.io/api?name=Alice&key=YOUR_API_KEY"Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
country | string | Código de país de dos letras, como ES o US. |
askToAI | boolean | Si es true, recurre al soporte de IA cuando el nombre no aparece en la base de datos. |
forceToGenderize | boolean | Intenta generar una estimación para entradas poco habituales que podrían no parecer nombres de persona. |
Género por email
Dirección de email
El endpoint de email extrae primero el nombre probable de la dirección y después realiza la detección de género.
https://api.genderapi.io/api/emailcurl "https://api.genderapi.io/api/email?email=alice.smith%40example.com&country=ES&askToAI=true&key=YOUR_API_KEY"forceToGenderize no está disponible en este endpoint porque el nombre se extrae internamente.Género por usuario
Nombre de usuario o alias
Utiliza este endpoint para nombres de usuario, identificadores y alias que puedan contener un nombre reconocible.
https://api.genderapi.io/api/usernamecurl "https://api.genderapi.io/api/username?username=sparkling_unicorn&country=ES&askToAI=true&forceToGenderize=true&key=YOUR_API_KEY"Respuesta JSON
Interpreta la respuesta de GenderAPI
Los tres endpoints comparten la misma estructura básica de respuesta.
{
"status": true,
"used_credits": 1,
"remaining_credits": 4999,
"expires": 1743659200,
"q": "Alice",
"name": "alice",
"gender": "female",
"country": "ES",
"total_names": 325,
"probability": 98,
"duration": "4ms"
}Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
status | boolean | Indica si la solicitud se ha completado correctamente. |
used_credits | integer | Créditos consumidos por esta solicitud. |
remaining_credits | integer | Créditos disponibles después de la solicitud. |
expires | integer | Fecha de vencimiento del paquete como marca de tiempo UNIX. |
q | string | Nombre, email o nombre de usuario enviado originalmente. |
name | string | Nombre normalizado o extraído de la entrada. |
gender | string | Género estimado: male, female o "null". |
country | string | Código de país ISO 3166-1 alfa-2 más probable. |
total_names | integer | Número de registros de nombres utilizados en la estimación. |
probability | integer | Nivel de confianza de la estimación expresado en porcentaje. |
duration | string | Tiempo de procesamiento de la solicitud en el servidor. |
Codifica siempre los valores de entrada en la URL
Tu cliente HTTP debe codificar los espacios y caracteres especiales. Por ejemplo, utiliza sparkling%20unicorn en lugar de incluir un espacio sin codificar.
Sigue desarrollando