Determina el género a partir de hasta 50 nombres de usuario

Resumen de solicitud en bulk

Procesar hasta 50 nombres de usuario

Enviar undataarray. GenderAPI extrae señales de nombre potenciales de cada handle y devuelve resultados con su registro opcionalid.

MethodPOST

Maximum50 nombres de usuario

Authenticationtoken Bearer

opciones de IANo disponible

Los resultados de nombres de usuario en bulk requieren una revisión cuidadosa.

Los handles pueden contener marcas, términos fantásticos o palabras no relacionadas. Los pedidos en bulk no aceptanaskToAI or forceToGenderize. Para un manejo de mayor confianza de entradas inusuales, use elsolo pedido.

HDR

Encabezados HTTP requeridos

Autorice la solicitud en bloque

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Cuerpo de solicitud JSON

Parámetros

Field	Type	Requirement	Description
`data`	object[]	Requerido	Array que contiene entre 1 y 50 registros de nombres de usuario.
`data[].username`	string	Requerido	Nombre de usuario o handle para analizar; se permiten guiones bajos y números.
`data[].country`	string	Opcional	Código alpha-2 de ISO 3166-1 utilizado como contexto regional.
`data[].id`	string \| integer	Opcional	Tu identificador, devuelto sin cambios junto con el resultado correspondiente.

Guía de entrada

Los nombres de usuario con caracteres latinos suelen proporcionar señales de nombre más claras. Utilice valores únicos y evalúe el extraídoidantes de actualizar los registros.name and probabilityConstruya el array de nombres de usuario

Carga del payload

Construya el array de nombres de usuario

JSON

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

Ejemplos de código

Envíe una solicitud con múltiples nombres de usuario

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 })
});

Respuesta 200

Nombres extraídos y predicciones

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 de respuesta

Field	Type	Description
`status`	boolean	Si la solicitud en volumen se completó con éxito.
`used_credits`	integer	Créditos consumidos en los nombres de usuario enviados.
`remaining_credits`	integer	Créditos disponibles después de la solicitud.
`expires`	integer	Hora de expiración del paquete como marca de tiempo UNIX.
`names`	object[]	Resultados para los nombres de usuario enviados.
`names[].name`	string	Nombre potencial extraído del nombre de usuario.
`names[].q`	string	Nombre de usuario original enviado en la solicitud.
`names[].gender`	string \| null	Valor predicho: masculino, femenino o nulo.
`names[].country`	string	Código del país considerado para este resultado.
`names[].total_names`	integer	Número de muestras que apoyan este resultado.
`names[].probability`	integer	Confianza de la predicción expresada como porcentaje.
`names[].id`	string \| integer	Identificador de entrada devuelto para correlación del registro.
`duration`	string	Tiempo total de procesamiento del servidor.

Mantener cada solicitud dentro de 50 registros

Dividir entradas más grandes en lotes. Un nombre de usuario es una señal indirecta, por lo tanto, verifique el nombre extraído y establezca un umbral de probabilidad aceptable antes de aplicar los resultados.

Referencia siguiente

Validar y formatear números de teléfono

Validación de números de teléfonoRevisar métodos de validación y formateo →Username solo pedidoUse opciones de IA for one handle →