Determine o gênero a partir de um nome de usuário ou apelido

Visão geral da solicitação

Do nome de usuário para o nome provável

GenderAPI busca sinais de nome dentro do handle fornecido, depois prediz o gênero usando evidências de banco de dados, contexto nacional e—quando solicitado—fallback com inteligência artificial.

Inputsparkling_unicorn

Sinal extraídoSparkling

Predictionfeminino · 92%

MethodPOST

Tipo de conteúdoapplication/json

AuthenticationToken Bearer

Opções de IAAvailable

HDR

Cabeçalhos HTTP obrigatórios

Autorizar a requisição

Content-Typeapplication/json

AuthorizationBearer SUA_CHAVE_API

Corpo da requisição em formato JSON

Parâmetros

Parameter	Type	Requirement	Description
`username`	string	Obrigatório	Nome de usuário, handle social, nome exibido ou apelido para analisar.
`country`	string	Opcional	Código alpha-2 do país segundo a ISO 3166-1, como US ou TR, para contexto regional.
`askToAI`	boolean	Opcional	Quando verdadeiro, utiliza fallback de IA se o nome extraído não tiver resultado na base de dados.
`forceToGenderize`	boolean	Opcional	Quando verdadeiro, tenta fazer uma previsão para aliases ou entradas que não se assemelham a nomes típicos.

askToAI

Use apenas quando o nome extraído não tiver resultado no banco de dados.

forceToGenderize

Permite tentativas para termos fantasia, aliases semelhantes a marcas e apelidos incomuns.

Confiança importa:Resultados forçados para sinais de nome fracos ou não humanos podem ser menos confiáveis. Avalieprobabilityantes de agir sobre uma previsão.

Exemplos de código

Enviar uma solicitação de nome de usuário

cURL

curl -X POST "https://api.genderapi.io/api/username" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"username":"sparkling_unicorn","country":"US","askToAI":true,"forceToGenderize":true}'

JavaScript

const response = await fetch("https://api.genderapi.io/api/username", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ username: "sparkling_unicorn", country: "US", askToAI: true, forceToGenderize: true })
});

Python

import requests
response = requests.post(
  "https://api.genderapi.io/api/username",
  headers={"Authorization": "Bearer YOUR_API_KEY"},
  json={"username": "sparkling_unicorn", "country": "US", "askToAI": True, "forceToGenderize": True}
)
print(response.json())

Resposta 200

Sinal extraído and prediction

JSON

{
  "status": true, "used_credits": 1, "remaining_credits": 4999,
  "expires": 1743659200, "q": "sparkling_unicorn",
  "name": "Sparkling", "gender": "female", "country": "US",
  "total_names": 9876, "probability": 92, "duration": "6ms"
}

Campos da resposta

Field	Type	Description
`status`	boolean	Indica se a solicitação foi concluída com sucesso.
`used_credits`	integer	Créditos consumidos pela solicitação.
`remaining_credits`	integer	Créditos disponíveis após a solicitação.
`expires`	integer	Hora de expiração do pacote em formato de timestamp UNIX.
`q`	string	Nome de usuário original enviado na solicitação.
`name`	string	Nome provável extraído a partir do nome de usuário.
`gender`	string \| null	Valor previsto: masculino, feminino ou nulo.
`country`	string	Código do país considerado para a previsão.
`total_names`	integer	Número de amostras que apoiam a previsão.
`probability`	integer	Confiança da previsão em porcentagem.
`duration`	string	Tempo de processamento do servidor.

Trate nomes de usuário como sinais indiretos

Um nome de usuário pode descrever uma marca, personagem ou conceito em vez de uma pessoa. Confirme se o sinal extraído é significativo e estabeleça um limite de probabilidade aceitável para seu caso de uso.nameé significativo e estabeleça um limite de probabilidade aceitável para seu caso de uso.

Próximo guia

Analise múltiplos nomes de usuário

Solicitação de múltiplos nomes de usuárioProcessar vários handles em uma solicitação →Solicitação de e-mail únicoExtraia um nome a partir de um e-mail →