GenderAPI.io · REST API v2
Estime o gênero provável a partir de um nome, nome completo, endereço de e-mail ou nome de usuário. A GenderAPI.io V2 retorna JSON estruturado com a origem da previsão, um valor de confiança e o contexto de país opcional.
GenderAPI.io V2
https://api.genderapi.io/api/v2/gender?type=name&value=MarianaResposta V2 real obtida em 1º de outubro de 2026. Envie uma requisição para ver um resultado em tempo real.
| Nome | Mariana |
|---|---|
| Gênero | Feminino |
| Confiança | 99,5% |
| País | Brasil (BR) |
| Fonte | Base de nomes |
| Créditos usados | 1 |
{
"data": {
"input": {
"type": "name",
"value": "Mariana",
"country": null
},
"name": "mariana",
"gender": "female",
"country": "BR",
"confidence": 0.9946884117603052,
"confidence_kind": "observed_frequency",
"sample_count": 40101,
"source": "dataset",
"result_status": "identified",
"reason": null,
"country_source": "dataset",
"match": {
"name": "mariana",
"method": "normalized",
"scope": "global",
"country": null
}
},
"meta": {
"request_id": "f0d3aac9-a4a6-4964-8a81-53e6a8c81a66",
"duration_ms": 10,
"access": {
"mode": "api_key",
"reason": null
},
"usage": {
"charged_credits": 1,
"remaining_credits": 49999,
"billing_status": "confirmed",
"resets_at": null,
"limit": null,
"period_seconds": null
}
}
}Análise de nomes e nomes completos
Consulte itens individuais, envie requisições em lote ou use nossas ferramentas para planilhas. A V2 distingue resultados com e sem previsão, para que sua aplicação preserve a incerteza em vez de forçar uma estimativa.
Gênero pelo nome
Receba uma estimativa com um valor de confiança e a origem da previsão. Quando não é possível fazer uma previsão, a V2 indica isso explicitamente como resultado desconhecido.
Gênero pelo e-mail
Interprete os sinais de nome nos formatos de e-mail mais comuns e enriqueça dados de CRM, leads e análises com a estimativa e sua origem.
Gênero pelo nome de usuário
Reconheça nomes conhecidos dentro de nomes de usuário. Com forceToGenderize, você pode solicitar uma estimativa até para apelidos sem um nome real, mas uma previsão não é garantida.
Processamento de Excel e CSV
Envie um arquivo Excel ou CSV, escolha a coluna de origem e baixe os resultados. Para requisições em lote a partir da sua aplicação, use o guia de requisições em lote da V2.
Integrações para a GenderAPI.io
Comece com a REST API ou conecte a GenderAPI.io a planilhas, plataformas de e-commerce e serviços de automação. Em cada guia, verifique qual versão da API a integração usa.
Perguntas frequentes
Conheça os tipos de requisição, a confiança, o acesso gratuito e o custo em créditos. Os formatos das requisições e os exemplos de código estão na documentação da V2.
Ver todas as perguntas frequentesA GenderAPI.io estima o gênero provável a partir de um nome, endereço de e-mail ou nome de usuário. A V2 retorna em JSON a previsão, a confiança, a origem e os créditos usados. São estimativas baseadas em padrões recorrentes nos nomes; elas não confirmam a identidade de gênero declarada por uma pessoa.
Uma requisição individual consulta primeiro o conjunto de dados. Se não houver previsão ali, a IA é usada por padrão. Esse modo padrão custa 1 crédito no total, incluindo a IA. Nas requisições em lote, a IA fica desativada por padrão. Você pode escolher um modo de IA ou ativar forceToGenderize para analisar apelidos.
Na V2, o campo confidence contém um valor de 0 a 1 ou null. O campo confidence_kind distingue a frequência observada no conjunto de dados de um valor informado pelo modelo; a confiança não garante que o resultado esteja correto. Quando não há previsão, a resposta contém gender: null e result_status: unknown.
Uma requisição V2 padrão custa 1 crédito, mesmo quando a IA é usada ou quando um resultado processado com sucesso não contém uma previsão. O modo de IA always custa 2 créditos. Com forceToGenderize, uma previsão do conjunto de dados custa 1 crédito; se a IA for necessária, o custo total é de 2 créditos. Nas requisições em lote, o custo é calculado por item.
Sim. A V2 aceita até 50 itens por lote com uma chave de API válida ou até 10 com o teste por IP. Assim, uma única requisição HTTP pode consumir vários créditos. Arquivos maiores também podem ser processados com as ferramentas para Excel e CSV ou por outras integrações.
Sem chave de API, a demonstração da V2 usa um teste por IP com 10 créditos a cada 24 horas, compartilhados por todos que usam o mesmo endereço IP. Uma conta gratuita recebe 200 créditos por dia. São cotas de créditos, não um número fixo de requisições: os modos de 2 créditos consomem o saldo mais rapidamente.
Sim. A V1 e a V2 usam a mesma chave de API e o mesmo saldo da conta. As integrações V1 existentes continuam disponíveis. As novas integrações devem se basear na documentação da V2, porque os endpoints, os campos de resposta e o formato dos erros são diferentes dos da V1.
Comece agora
Crie uma conta, teste suas primeiras requisições com 200 créditos grátis por dia e processe arquivos Excel ou CSV quando precisar.