Faça sua primeira requisição
Envie um nome, um endereço de e-mail ou um nome de usuário para receber uma previsão de gênero em JSON. Teste no navegador a URL abaixo sem chave de API e depois escolha um guia para conectar sua aplicação.
O teste por IP gratuito inclui 10 créditos por endereço IP a cada 24 horas, compartilhados com a V1. Este exemplo usa apenas o conjunto de dados e custa 1 crédito por requisição, inclusive a cada vez que a página é recarregada. Quando você conecta sua chave de API existente, a V1 e a V2 usam o mesmo saldo da conta.
https://api.genderapi.io/api/v2/gender?type=name&value=Camila&country=BR&ai_mode=offO que você quer fazer?
Escolha o tipo de entrada para ver exemplos prontos para executar em cURL, JavaScript, Python, PHP, Java, C# e Go. Consulte os guias de resultados e de cobrança quando estiver pronto para tratar respostas reais.
Primeiros passos
Enviar requisições
- Gênero pelo nome Consulte um primeiro nome ou um nome completo.
- Gênero pelo e-mail Encontre um sinal de nome em um endereço de e-mail.
- Gênero pelo nome de usuário Use um nome de usuário ou um apelido como entrada.
- Requisições em lote Processe até 50 nomes, endereços de e-mail ou nomes de usuário de uma só vez.
- Validação de telefone Verifique e formate um número de telefone.
Entender resultados e custos
Referência de endpoints
Combine https://api.genderapi.io com os caminhos absolutos desta tabela. Por exemplo: https://api.genderapi.io/api/v2/gender. Parâmetros de consulta são aceitos apenas em GET /gender. Use corpos JSON nas rotas POST; não envie campos da V1, como name, email, username ou askToAI, em uma requisição V2.
| Método | Caminho | Finalidade |
|---|---|---|
| GET | /api/v2 | Recursos públicos e limites atuais; gratuito. |
| GET | /api/v2/openapi.json | Contrato OpenAPI canônico; gratuito. |
| GET | /api/v2/errors | Catálogo de erros legível por máquina; gratuito. |
| GET | /api/v2/usage | Saldo atual da conta ou do teste por IP; gratuito. |
| 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, endereços de e-mail e/ou nomes de usuário. |
| POST | /api/v2/phone/validate | Valide e formate um número de telefone. |