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

API de estimación de edad: predecir la edad a partir del nombre

Predice la edad más probable para un nombre determinado utilizando un modelo estadístico basado en censos públicos y datos demográficos. Opcionalmente, filtre por país para obtener estimaciones específicas de la región. Devuelve la edad prevista y el recuento de muestras utilizado para la predicción.

Parameters

stringrequired

First name to estimate age for.

string

ISO 3166-1 alpha-2 country code to narrow the estimate to a specific country.

Code examples

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

When to use this API

Segmentación demográfica para marketing.

Calcule la distribución por edades de su base de usuarios a partir de los nombres en su base de datos de registro. Segmente a los usuarios en grupos de edad (18-25, 26-35, 36-50, 50+) y adapte campañas de correo electrónico, recomendaciones de productos y creatividades publicitarias a cada segmento.

Prerrelleno de formularios y optimización de UX

Utilice la edad estimada para preseleccionar opciones relevantes en los formularios de incorporación. Para una aplicación de servicios financieros, si la edad prevista es mayor de 60 años, se utiliza de forma predeterminada el contenido de planificación de la jubilación. Para las edades previstas entre 20 y 30 años, resalte los préstamos para estudiantes o los recursos para compradores de primera vivienda.

Enriquecimiento de datos para registros de CRM

Enriquezca los contactos de CRM que tienen un nombre pero no tienen edad ni fecha de nacimiento. Agregue un campo de edad estimada que los equipos de ventas puedan usar para un alcance más personalizado. Marque predicciones de baja confianza (valores de recuento pequeños) para su revisión manual.

Frequently asked questions

¿Qué tan precisa es la predicción de la edad?
La precisión depende del nombre y el país. Los nombres comunes con un gran número de muestras (más de 100.000) suelen predecirse entre 5 y 8 años después del promedio real. Los nombres raros o populares a lo largo de varias generaciones tienen una variación más amplia. El campo de recuento indica confianza; recuentos más altos significan predicciones más confiables.
¿Qué representa el campo de recuento?
El recuento es el número de muestras de datos utilizadas para calcular la edad prevista. Un recuento de 233.482 significa que la predicción se basa en más de 233.000 registros con ese nombre. Los recuentos más altos generalmente producen estimaciones más confiables.
¿El parámetro country_id cambia el resultado?
Sí. La popularidad de los nombres y la distribución por edades varían según el país. "Michael" se asocia con un grupo demográfico de mayor edad en los EE. UU., pero puede ser más joven en otros países. Proporcionar un country_id proporciona una estimación más específica.
¿Puedo estimar la edad de cualquier idioma o escritura?
El modelo funciona mejor con nombres en escritura latina comunes en los países occidentales. Los nombres en escrituras no latinas (china, árabe, cirílica) pueden tener recuentos de muestras más bajos y predicciones menos confiables.
¿El nombre distingue entre mayúsculas y minúsculas?
No. Los nombres se normalizan a minúsculas antes de procesarlos. "Michael", "michael" y "MICHAEL" devuelven el mismo resultado.

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