Obter Gênero pelo Nome de Usuário - Requisição Única

O endpoint Get Gender by Username permite determinar o gênero de uma pessoa analisando um nome de usuário ou apelido. Todos os parâmetros são enviados via requisição POST em formato JSON. Você deve se autenticar utilizando o método Bearer token no cabeçalho Authorization.

URL da Requisição

POST https://api.genderapi.io/api/username

Cabeçalhos HTTP Necessários

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Parâmetros do Corpo da Requisição (Request Body)

Parâmetro	Tipo	Obrigatório	Descrição
username	String	Sim	O nome de usuário ou apelido a ser analisado. Pode ser um handle de redes sociais, nome de tela ou apelido. Pode conter termos que não sejam nomes reais, como termos fantasiosos ou referências a marcas.
country	String	Não	Um código de país de duas letras (ISO 3166-1 alpha-2) para aumentar a precisão da previsão. Exemplo: `TR` para Turquia.
askToAI	Boolean	Não	Se definido como `true`, a API consultará um modelo de IA para determinar o gênero caso o nome extraído não seja encontrado no banco de dados.
forceToGenderize	Boolean	Não	Se definido como `true`, a API tentará adivinhar o gênero mesmo para nomes de usuário que não pareçam nomes reais, como termos fantasiosos ou apelidos (ex.: `sparkling_unicorn`).

Exemplos de Requisições

Exemplo com 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}'

Exemplo com PHP cURL

<?php
$url = "https://api.genderapi.io/api/username";

$data = array(
    "username" => "sparkling_unicorn",
    "country" => "US",
    "askToAI" => true,
    "forceToGenderize" => true
);

$payload = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    "Content-Type: application/json",
    "Authorization: Bearer YOUR_API_KEY"
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Exemplo com JavaScript fetch

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
  })
})
.then(response => response.json())
.then(data => console.log(data));

Exemplo com Python requests

import requests

url = "https://api.genderapi.io/api/username"

payload = {
    "username": "sparkling_unicorn",
    "country": "US",
    "askToAI": True,
    "forceToGenderize": True
}

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.post(url, headers=headers, json=payload)

print(response.json())

Exemplo de Resposta 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 na Resposta

Campo	Tipo	Descrição
status	Boolean	Indica se a requisição foi bem-sucedida.
used_credits	Integer	Número de créditos consumidos nesta requisição.
remaining_credits	Integer	Créditos restantes na sua conta após esta requisição.
expires	Integer (timestamp)	Data de expiração do seu pacote, no formato timestamp UNIX.
q	String	Sua consulta de entrada (username enviado).
name	String	O primeiro nome extraído do username.
gender	Enum[String]	Gênero previsto. Valores possíveis: `male`, `female` ou `null`.
country	String	Código do país considerado durante a previsão.
total_names	Integer	Número de amostras usadas para essa previsão.
probability	Integer	Porcentagem de confiança na previsão de gênero.
duration	String	Tempo necessário para processar a requisição (ex.: `6ms`).