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

Resumen de la solicitud

De nombre de usuario a nombre probable

GenderAPI busca señales de nombre dentro del handle enviado, luego predice el género utilizando evidencia de base de datos, contexto de país y—cuando se solicita—un respaldo mediante inteligencia artificial.

Inputsparkling_unicorn

Señal extraídaSparkling

Predictionfemenino · 92%

MethodPOST

Tipo de contenidoapplication/json

AuthenticationToken Bearer

Opciones de IAAvailable

HDR

Encabezados HTTP requeridos

Autorizar la solicitud

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Cuerpo de solicitud en formato JSON

Parámetros

Parameter	Type	Requirement	Description
`username`	string	Obligatorio	Nombre de usuario, handle social, nombre de pantalla o apodo para analizar.
`country`	string	Opcional	Código alpha-2 de país según ISO 3166-1, como EE.UU. o TR, para contexto regional.
`askToAI`	boolean	Opcional	Cuando es verdadero, se utiliza el respaldo de inteligencia artificial si el nombre extraído no tiene resultado en la base de datos.
`forceToGenderize`	boolean	Opcional	Cuando es verdadero, se intenta una predicción para alias o entradas que no se asemejan a nombres típicos.

askToAI

Utilice solo cuando el nombre extraído no tenga resultado en la base de datos.

forceToGenderize

Permite intentos para términos fantásticos, alias similares a marcas y apodos inusuales.

La confianza importa:Los resultados forzados para señales débiles o no humanas pueden ser menos confiables. Evalúeprobabilityantes de actuar sobre una predicción.

Ejemplos de código

Enviar una solicitud de nombre de usuario

cURL

curl -X POST "https://api.genderapi.io/api/username" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"username":"sparkling_unicorn","country":"US","askToAI":true,"forceToGenderize":true}'

JavaScript

const response = await fetch("https://api.genderapi.io/api/username", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ username: "sparkling_unicorn", country: "US", askToAI: true, forceToGenderize: true })
});

Python

import requests
response = requests.post(
  "https://api.genderapi.io/api/username",
  headers={"Authorization": "Bearer YOUR_API_KEY"},
  json={"username": "sparkling_unicorn", "country": "US", "askToAI": True, "forceToGenderize": True}
)
print(response.json())

Respuesta 200

Señal extraída and prediction

JSON

{
  "status": true, "used_credits": 1, "remaining_credits": 4999,
  "expires": 1743659200, "q": "sparkling_unicorn",
  "name": "Sparkling", "gender": "female", "country": "US",
  "total_names": 9876, "probability": 92, "duration": "6ms"
}

Campos de la respuesta

Field	Type	Description
`status`	boolean	Indica si la solicitud se completó con éxito.
`used_credits`	integer	Créditos consumidos por esta solicitud.
`remaining_credits`	integer	Créditos disponibles después de la solicitud.
`expires`	integer	Hora de expiración del paquete en formato UNIX.
`q`	string	Nombre de usuario original enviado en la solicitud.
`name`	string	Nombre probablemente extraído del nombre de usuario.
`gender`	string \| null	Valor predicho: masculino, femenino o nulo.
`country`	string	Código de país considerado para la predicción.
`total_names`	integer	Número de muestras que apoyan la predicción.
`probability`	integer	Confianza de la predicción expresada como porcentaje.
`duration`	string	Tiempo de procesamiento del servidor.

Tratar los nombres de usuario como señales indirectas

Un nombre de usuario puede describir una marca, un personaje o un concepto en lugar de una persona. Confirmar que la señal extraída sea significativa y establecer umbral de probabilidad aceptable para su caso de uso.namees significativo y establecer umbral de probabilidad aceptable para su caso de uso.

Guía siguiente

Analizar múltiples nombres de usuario

Solicitud de varios nombres de usuarioProcesar varios perfiles en una sola solicitud →Solicitud de correo electrónico únicoExtraer un nombre de un correo electrónico →