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

API de detecção de gênero - Preveja o gênero a partir do primeiro nome

Prevê o gênero associado a um primeiro nome usando modelos estatísticos treinados em dados demográficos públicos. Retorna "masculino" ou "feminino" com uma pontuação de probabilidade (0-1) e a contagem da amostra. Opcionalmente, restrinja os resultados por país para obter precisão específica da região.

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

Saudações personalizadas por e-mail

Quando seu CRM tiver um primeiro nome, mas nenhum campo de gênero, use este endpoint para prever o gênero e gerar saudações apropriadas ("Prezado Sr. Smith" vs "Prezada Sra. Johnson"). Aplique apenas previsões com probabilidade acima de 0,90 para evitar erros.

Enriquecimento demográfico de pesquisa e análise

Enriqueça as respostas da pesquisa ou as análises dos usuários com o gênero previsto quando as informações não foram coletadas diretamente. Use os dados para relatórios agregados sobre distribuição de gênero em sua base de usuários, padrões de uso de produtos ou resultados de testes A/B.

Recomendações de produtos de comércio eletrônico

Preveja o sexo a partir do primeiro nome do titular da conta para personalizar categorias de produtos padrão. Mostre recomendações de roupas, acessórios ou presentes alinhadas com o gênero previsto, ao mesmo tempo que oferece uma opção fácil para os usuários atualizarem suas preferências.

Frequently asked questions

Quais valores o campo gênero retorna?
O campo gênero retorna “masculino” ou “feminino” com base na maioria estatística desse nome. Para nomes com probabilidade quase igual (por exemplo, "Alex"), a resposta reflete a ligeira maioria e a probabilidade será próxima de 0,50.
O que significa a pontuação de probabilidade?
A probabilidade é um valor entre 0 e 1 indicando confiança. Uma pontuação de 0,98 significa que 98% das pessoas com esse nome no conjunto de dados se identificam com o sexo previsto. Pontuações abaixo de 0,60 indicam que o nome é fortemente unissex.
O country_id afeta os resultados?
Sim. Alguns nomes têm diferentes associações de género em diferentes países. "Andrea" é predominantemente feminina nos países de língua inglesa, mas masculina na Itália. Fornecer um country_id fornece previsões regionais mais precisas.
Como devo lidar com previsões de baixa probabilidade?
Para previsões com probabilidade abaixo de 0,70, trate o nome como ambíguo em termos de gênero. Use uma linguagem neutra em termos de gênero nas comunicações e considere perguntar diretamente ao usuário, em vez de presumir.
Posso prever o sexo de apelidos ou nomes abreviados?
Sim, se o apelido for comum o suficiente para aparecer no conjunto de dados. “Mike” retornará como homem, “Liz” retornará como mulher. Abreviações incomuns podem ter contagens de amostras mais baixas e previsões menos confiáveis.

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