# Documentação GenderAPI v2

> Faça sua primeira solicitação, conecte sua aplicação e entenda os resultados. Comece com um nome, endereço de e-mail ou nome de usuário.

Canonical HTML: https://www.genderapi.io/pt/api-documentation

Last reviewed: 2026-09-25

## Faça sua primeira solicitação

Envie um nome, endereço de e-mail ou nome de usuário para obter uma previsão de gênero JSON. Experimente o URL abaixo em seu navegador sem uma chave API e escolha um guia para conectar seu aplicativo.

A avaliação gratuita oferece 10 créditos por endereço IP a cada 24 horas. Esta cota é compartilhado com v1. O exemplo abaixo usa apenas o conjunto de dados e deduz 1 crédito cada vez que você envia a solicitação, inclusive quando você atualiza a página. Com uma chave API, v1 e v2 deduzem créditos do mesmo saldo da conta.

```text
https://api.genderapi.io/api/v2/gender?type=name&value=Onur&country=TR&ai_mode=off
```

- [Abra o exemplo GET (usa 1 crédito de teste)](https://api.genderapi.io/api/v2/gender?type=name&value=Onur&country=TR&ai_mode=off)
- [Configure sua chave API](https://www.genderapi.io/pt/docs/v2/authentication#environment-setup)
- [Entenda a resposta JSON](https://www.genderapi.io/pt/docs/v2/responses)

## O que você gostaria de fazer?

Escolha seu tipo de entrada para exemplos de trabalho em cURL, JavaScript, Python, PHP, Java, C# e Go. Use os guias de resultados e faturamento quando estiver pronto para lidar com respostas reais.

- [Chave de API e teste gratuito](https://www.genderapi.io/pt/docs/v2/authentication): Conecte sua chave API ou experimente o API gratuitamente.
- [Parâmetros de solicitação](https://www.genderapi.io/pt/docs/v2/request-parameters): Escolha os campos de entrada, o contexto do país e as opções de solicitação.
- [Gênero pelo nome](https://www.genderapi.io/pt/docs/v2/gender-from-name): Procure um nome ou nome completo.
- [Gênero pelo e-mail](https://www.genderapi.io/pt/docs/v2/gender-from-email): Encontre um sinal de nome em um endereço de e-mail.
- [Gênero pelo nome de usuário](https://www.genderapi.io/pt/docs/v2/gender-from-username): Use um nome de usuário ou apelido como entrada.
- [Consultas em lote](https://www.genderapi.io/pt/docs/v2/batch): Processe até 50 nomes, e-mails ou nomes de usuário de uma só vez.
- [Validação de telefone](https://www.genderapi.io/pt/docs/v2/phone-validation): Verifique e formate um número de telefone.
- [Interpretar uma resposta](https://www.genderapi.io/pt/docs/v2/responses): Leia previsões, pontuações de confiança e resultados desconhecidos.
- [IA e apelidos](https://www.genderapi.io/pt/docs/v2/ai-options): Escolha quando usar IA e como lidar com apelidos.
- [Créditos e saldo](https://www.genderapi.io/pt/docs/v2/credits-and-usage): Verifique seu saldo e quanto custa cada solicitação.
- [Erros e novas tentativas](https://www.genderapi.io/pt/docs/v2/errors-and-retries): Resolva erros e decida quando tentar novamente.
- [Migrar da V1](https://www.genderapi.io/pt/docs/v2/migration): Atualize uma integração existente usando a mesma chave API.

## Referência de ponto final

Combine https://api.genderapi.io com os caminhos absolutos nesta tabela. Por exemplo: https://api.genderapi.io/api/v2/gender. Os parâmetros de consulta são suportados apenas em GET /gender. Use corpos JSON para rotas POST; não envie campos v1 como name, email, username ou askToAI em uma solicitação v2.

| Método | Caminho | Objetivo |
| --- | --- | --- |
| GET | /api/v2 | Capacidades públicas e limites atuais; livre. |
| GET | /api/v2/openapi.json | Contrato canônico OpenAPI; livre. |
| GET | /api/v2/errors | Catálogo de erros legível por máquina; livre. |
| GET | /api/v2/usage | Conta corrente ou balancete; livre. |
| GET / POST | /api/v2/gender | Um nome, endereço de e-mail ou nome de usuário. |
| POST | /api/v2/gender/batch | Um lote ordenado de nomes, e-mails e nomes de usuário /or. |
| POST | /api/v2/phone/validate | Valide e formate um número de telefone. |