Pular para o conteúdo
POST AI agent ready /v1/age/estimate

API de estimativa de idade - Preveja a idade a partir do primeiro nome

Prevê a idade mais provável para um determinado nome usando um modelo estatístico treinado em censos públicos e dados demográficos. Opcionalmente, filtre por país para obter estimativas específicas da região. Retorna a idade prevista e a contagem da amostra usada para a previsão.

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

Segmentação demográfica para marketing

Estime a distribuição etária de sua base de usuários a partir dos primeiros nomes em seu banco de dados de inscrição. Segmente os usuários em faixas etárias (18-25, 26-35, 36-50, 50+) e personalize campanhas de e-mail, recomendações de produtos e criativos de anúncios para cada segmento.

Pré-preenchimento de formulário e otimização UX

Use a idade estimada para pré-selecionar opções relevantes nos formulários de integração. Para um aplicativo de serviços financeiros, se a idade prevista for 60+, o padrão é o conteúdo de planejamento de aposentadoria. Para idades previstas entre 20 e 30 anos, destaque os recursos para empréstimos estudantis ou para o comprador da primeira casa.

Enriquecimento de dados para registros de CRM

Enriqueça os contatos do CRM que têm nome, mas não têm idade ou data de nascimento. Adicione um campo de idade estimada que as equipes de vendas possam usar para um alcance mais personalizado. Sinalize previsões de baixa confiança (valores de contagem pequenos) para revisão manual.

Frequently asked questions

Quão precisa é a previsão de idade?
A precisão depende do nome e do país. Nomes comuns com grandes contagens de amostras (mais de 100 mil) normalmente são previstos dentro de 5 a 8 anos da média real. Nomes raros ou nomes populares em várias gerações apresentam uma variação maior. O campo de contagem indica confiança; contagens mais altas significam previsões mais confiáveis.
O que o campo de contagem representa?
A contagem é o número de amostras de dados usadas para calcular a idade prevista. Uma contagem de 233.482 significa que a previsão é baseada em mais de 233 mil registros com esse nome. Contagens mais altas geralmente produzem estimativas mais confiáveis.
O parâmetro country_id altera o resultado?
Sim. A popularidade dos nomes e a distribuição etária variam de acordo com o país. “Michael” está associado a um grupo demográfico mais velho nos EUA, mas pode ser mais jovem em outros países. Fornecer um country_id fornece uma estimativa mais direcionada.
Posso estimar a idade para qualquer idioma ou escrita?
O modelo tem melhor desempenho com nomes em escrita latina comuns nos países ocidentais. Nomes em escritas não latinas (chinês, árabe, cirílico) podem ter contagens de amostras mais baixas e previsões menos confiáveis.
O nome diferencia maiúsculas de minúsculas?
Não. Os nomes são normalizados para letras minúsculas antes do processamento. "Michael", "michael" e "MICHAEL" retornam o mesmo 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