Ir al contenido
POST AI agent ready /v1/gender/estimate

API de detección de género: predecir el género a partir del nombre

Predice el género asociado con un nombre utilizando modelos estadísticos entrenados en datos demográficos públicos. Devuelve "masculino" o "femenino" con una puntuación de probabilidad (0-1) y el recuento de la muestra. Opcionalmente, limite los resultados por país para obtener precisión específica de la región.

Parameters

stringrequired

First name to predict gender for.

string

ISO 3166-1 alpha-2 country code for country-specific prediction.

Code examples

curl -X POST https://api.botoi.com/v1/gender/estimate \
  -H "Content-Type: application/json" \
  -d '{"name":"Maria","country_id":"US"}'

When to use this API

Saludos personalizados por correo electrónico

Cuando su CRM tenga un nombre pero ningún campo de género, utilice este punto final para predecir el género y generar saludos apropiados ("Estimado Sr. Smith" frente a "Estimada Sra. Johnson"). Aplique únicamente predicciones con una probabilidad superior a 0,90 para evitar errores.

Enriquecimiento demográfico mediante encuestas y análisis

Enriquezca las respuestas de las encuestas o los análisis de los usuarios con el género previsto cuando la información no se recopiló directamente. Utilice los datos para generar informes agregados sobre la distribución por género en su base de usuarios, patrones de uso de productos o resultados de pruebas A/B.

Recomendaciones de productos de comercio electrónico

Prediga el género a partir del nombre del titular de la cuenta para personalizar las categorías de productos predeterminadas. Muestre recomendaciones de ropa, accesorios o regalos alineados con el género previsto y, al mismo tiempo, proporcione una opción sencilla para que los usuarios actualicen sus preferencias.

Frequently asked questions

¿Qué valores devuelve el campo de género?
El campo de género devuelve "masculino" o "femenino" según la mayoría estadística para ese nombre. Para nombres con probabilidad casi igual (por ejemplo, "Alex"), la respuesta refleja una ligera mayoría y la probabilidad será cercana a 0,50.
¿Qué significa la puntuación de probabilidad?
La probabilidad es un valor entre 0 y 1 que indica confianza. Una puntuación de 0,98 significa que el 98% de las personas con ese nombre en el conjunto de datos se identifican con el género previsto. Las puntuaciones inferiores a 0,60 indican que el nombre es fuertemente unisex.
¿El country_id afecta los resultados?
Sí. Algunos nombres tienen diferentes asociaciones de género en diferentes países. "Andrea" es predominantemente femenina en los países de habla inglesa, pero masculina en Italia. Proporcionar un country_id proporciona predicciones regionales más precisas.
¿Cómo debo manejar las predicciones de baja probabilidad?
Para predicciones con probabilidad inferior a 0,70, trate el nombre como ambiguo en cuanto a género. Utilice un lenguaje neutral en cuanto al género en las comunicaciones y considere preguntarle al usuario directamente en lugar de asumirlo.
¿Puedo predecir el género de apodos o nombres abreviados?
Sí, si el apodo es lo suficientemente común como para aparecer en el conjunto de datos. "Mike" regresará hombre, "Liz" regresará mujer. Las abreviaturas poco comunes pueden tener recuentos de muestras más bajos y predicciones menos confiables.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs