Determinar o gênero a partir de até 50 endereços de e-mail

Visão geral da solicitação em lote

Processamento de até 50 endereços de e-mail

Enviar umdataarray. O GenderAPI extrai um nome provável de cada endereço e retorna a previsão correspondente; seu opcionalidfaz a correlação com a base de dados determinística.

MethodPOST

Maximum50 e-mails

Authenticationtoken Bearer

Formato do resultadonames[]

50 e-mails maxExtração de nomeResultados com consciência de país

HDR

Cabeçalhos HTTP obrigatórios

Autorize a solicitação em lote

Content-Typeapplication/json

AuthorizationBearer SUA_CHAVE_API

Corpo da solicitação em JSON

Parâmetros

Field	Type	Requirement	Description
`data`	object[]	Obrigatório	Array contendo entre 1 e 50 registros de e-mail.
`data[].email`	string	Obrigatório	Endereço de e-mail a partir do qual o GenderAPI extrai um nome provável de primeiro nome.
`data[].country`	string	Opcional	Código alpha-2 do ISO 3166-1 usado como contexto regional.
`data[].id`	string \| integer	Opcional	Seu identificador de registro, retornado sem alterações juntamente com o resultado correspondente.

Correspondência de registro

Use um únicoidPara cada item. A GenderAPI retorna-o juntamente com o resultado do item, permitindo que você atualize o registro correto do banco de dados sem depender apenas da posição do array.

Corpo da solicitação

Construa o array de e-mails

JSON

{
  "data": [
    { "email": "andrea.schmidt@example.com", "country": "DE", "id": "123" },
    { "email": "andrea.rossi@example.it", "country": "IT", "id": "456" },
    { "email": "james.brown@example.com", "country": "US", "id": "789" }
  ]
}

Exemplos de código

Envie uma solicitação com múltiplos e-mails

cURL

curl -X POST "https://api.genderapi.io/api/email/multi/country" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"data":[{"email":"andrea.schmidt@example.com","country":"DE","id":"123"},{"email":"james.brown@example.com","country":"US","id":"789"}]}'

JavaScript

const data = [
  { email: "andrea.schmidt@example.com", country: "DE", id: "123" },
  { email: "james.brown@example.com", country: "US", id: "789" }
];
const response = await fetch("https://api.genderapi.io/api/email/multi/country", {
  method: "POST", headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ data })
});

Resposta com código 200

Nomes extraídos e previsões

JSON

{
  "status": true, "used_credits": 3, "remaining_credits": 7265,
  "expires": 1717069765,
  "names": [
    { "name": "Andrea", "q": "andrea.schmidt@example.com", "gender": "female", "country": "DE", "total_names": 644, "probability": 88, "id": "123" },
    { "name": "James", "q": "james.brown@example.com", "gender": "male", "country": "US", "total_names": 45274, "probability": 100, "id": "789" }
  ], "duration": "5ms"
}

Campos da resposta

Field	Type	Description
`status`	boolean	Se a solicitação em lote foi concluída com sucesso.
`used_credits`	integer	Créditos consumidos em todos os e-mails enviados.
`remaining_credits`	integer	Créditos disponíveis após a solicitação.
`expires`	integer	Data de expiração do pacote como um timestamp UNIX.
`names`	object[]	Coleção ordenada de resultados para os e-mails enviados.
`names[].name`	string	Nome de solteiro extraído do endereço de e-mail.
`names[].q`	string	E-mail 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 do servidor.

Mantenha cada solicitação dentro de 50 registros

Valide cada endereço e divida conjuntos de dados maiores em batches de no máximo 50. Verifique o extraídoname and probabilityantes de aplicar um resultado.

Próximo passo

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

Solicitação individual de nome de usuárioExtraia um nome a partir de um único nome de usuário →Solicitação individual de e-mailUsar fallback de IA para um e-mail →