# Gender API para nomes, e-mails e nomes de usuário

> 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.

Canonical HTML: https://www.genderapi.io/pt

Last reviewed: 2026-09-29

## Informações gerais

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.

## Teste uma requisição V2 com um nome

Cada requisição custa 1 crédito. Se nenhuma chave estiver salva ou se a chave não for reconhecida, é usado o teste por IP com 10 créditos a cada 24 horas, compartilhados por todos os usuários do mesmo endereço IP.

Resposta V2 real obtida em 1º de outubro de 2026. Envie uma requisição para ver um resultado em tempo real.

**Resposta representativa; não é o resultado de uma consulta ao vivo**

```json
{
  "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
    }
  }
}
```

- [Abrir a demonstração ao vivo na página HTML](https://www.genderapi.io/pt#name-demo)

## Uma Gender API para nomes do mundo todo

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.

A cobertura depende do nome e do país: Mundo todo

Confiança com origem e interpretação: 0–1

Resultado e créditos usados em JSON: V2

Itens por lote com chave de API; 10 com o teste por IP: 50

## Estime o gênero a partir de um nome ou nome completo

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.

- Nomes e nomes completos

- Contexto de país opcional quando o país é conhecido

- Nomes em alfabetos latinos e não latinos

- [Conheça a API V2 para nomes →](https://www.genderapi.io/pt/docs/v2/gender-from-name)

## Use os sinais de nome em endereços de 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.

- Endereços pessoais e corporativos

- Enriquecimento de registros de CRM

- Confiança e origem na resposta

- [Conheça a API V2 para e-mails →](https://www.genderapi.io/pt/docs/v2/gender-from-email)

## Analise nomes de usuário e apelidos

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.

- Dados de usuários de redes sociais e comunidades

- Análise opcional de apelidos

- Status claro quando não há previsão

- [Conheça a API V2 para nomes de usuário →](https://www.genderapi.io/pt/docs/v2/gender-from-username)

## Processe listas de nomes em lote

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.

- Arquivos Excel e CSV

- Colunas com nomes, nomes completos ou endereços de e-mail

- Contexto de país opcional

- [Leia o guia de requisições em lote da V2 →](https://www.genderapi.io/pt/docs/v2/batch)

## Integre a API ou conecte as ferramentas que você já usa

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.

- [Ver todas as integrações](https://www.genderapi.io/pt/integrations)

## O que você precisa saber antes de começar

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 frequentes →](https://www.genderapi.io/pt/frequently-asked-questions)

### O que é a GenderAPI.io?

A 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.

### Quando a V2 usa IA?

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.

### Como interpreto a confiança e os resultados desconhecidos?

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.

### Quantos créditos custa uma requisição?

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.

### Posso enviar vários itens em uma única requisição?

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.

### Posso testar a API gratuitamente?

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.

### Minha chave de API atual funciona com a V2?

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.

## Teste a GenderAPI.io gratuitamente

Crie uma conta, teste suas primeiras requisições com 200 créditos grátis por dia e processe arquivos Excel ou CSV quando precisar.

- [Criar conta](https://app.genderapi.io/user/register)
- [Ver documentação](https://www.genderapi.io/pt/api-documentation)