Determine o gênero a partir de até 50 nomes de usuário

Visão geral da solicitação em lote

Processar até 50 nomes de usuário

Envie umdataarray. O GenderAPI extrai sinais potenciais de nomes de cada handle e retorna resultados com seu registro opcionalid.

MethodPOST

Maximum50 nomes de usuário

Authenticationtoken Bearer

opções de IANão suportado

Os resultados em massa de nomes de usuário precisam ser revisados com cuidado.

Os handles podem conter marcas, termos fantásticos ou palavras sem relação. As solicitações em massa não aceitamaskToAI or forceToGenderize. Para tratamento de inputs inusitados com maior confiança, use osolicitação única.

HDR

Cabeçalhos HTTP obrigatórios

Autorize a solicitação em lote

Content-Typeapplication/json

AuthorizationBearer SUA_CHAVE_API

Corpo da solicitação JSON

Parâmetros

Field	Type	Requirement	Description
`data`	object[]	Obrigatório	Array contendo entre 1 e 50 registros de usuário.
`data[].username`	string	Obrigatório	Usuário ou handle para análise; underscores e números são suportados.
`data[].country`	string	Opcional	Código alpha-2 do país conforme ISO 3166-1, usado como contexto regional.
`data[].id`	string \| integer	Opcional	Seu identificador, retornado sem alterações juntamente com o resultado correspondente.

Diretrizes de entrada

Usuários com caracteres latinos geralmente fornecem sinais de nome mais claros. Use valores únicos e avalie o extraídoidantes de atualizar os registros.name and probabilityConstrua o array de usuário

Corpo da solicitação

Construa o array de nome de usuário

JSON

{
  "data": [
    { "username": "anna_smith88", "country": "US", "id": "123" },
    { "username": "michael_bauer", "country": "DE", "id": "456" },
    { "username": "giulia_rossi", "country": "IT", "id": "789" }
  ]
}

Exemplos de código

Envie uma solicitação com múltiplos nomes de usuário

cURL

curl -X POST "https://api.genderapi.io/api/username/multi/country" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"data":[{"username":"anna_smith88","country":"US","id":"123"},{"username":"michael_bauer","country":"DE","id":"456"}]}'

JavaScript

const data = [
  { username: "anna_smith88", country: "US", id: "123" },
  { username: "michael_bauer", country: "DE", id: "456" }
];
const response = await fetch("https://api.genderapi.io/api/username/multi/country", {
  method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ data })
});

Resposta 200

Nomes extraídos e previsões

JSON

{
  "status": true, "used_credits": 3, "remaining_credits": 7265, "expires": 1717069765,
  "names": [
    { "name": "Anna", "q": "anna_smith88", "gender": "female", "country": "US", "total_names": 1234, "probability": 92, "id": "123" },
    { "name": "Michael", "q": "michael_bauer", "gender": "male", "country": "DE", "total_names": 5678, "probability": 89, "id": "456" }
  ], "duration": "5ms"
}

Campos da resposta

Field	Type	Description
`status`	boolean	Se o pedido em lote foi concluído com sucesso.
`used_credits`	integer	Créditos consumidos pelos nomes enviados.
`remaining_credits`	integer	Créditos disponíveis após a solicitação.
`expires`	integer	Hora de expiração do pacote como um timestamp UNIX.
`names`	object[]	Resultados para os nomes enviados.
`names[].name`	string	Nome potencial extraído do nome de usuário.
`names[].q`	string	Nome de usuário original enviado na solicitação.
`names[].gender`	string \| null	Valor previsto: masculino, feminino ou nulo.
`names[].country`	string	Código do país considerado para este resultado.
`names[].total_names`	integer	Número de amostras que apoiam este resultado.
`names[].probability`	integer	Confiança da previsão em porcentagem.
`names[].id`	string \| integer	Identificador de entrada retornado para correlação do registro.
`duration`	string	Tempo total de processamento no servidor.

Mantenha cada solicitação dentro de 50 registros

Divida entradas maiores em batches. Um nome de usuário é um sinal indireto, portanto, verifique o nome extraído e estabeleça um limite de probabilidade aceitável antes de aplicar os resultados.

Próximo referencial

Valide e formate números de telefone

Validação de telefoneRevise os métodos de validação e formatação →Username solicitação únicaUse opções de IA for one handle →