API de Género por Lotes | Analizar Varios Nombres

Resumen de la solicitud por lotes

Procesa hasta 100 nombres

Envía un array data y recibe un resultado por registro. Añade el id de tu sistema para asociar cada estimación con su registro de origen de forma fiable.

MétodoPOST

Máximo100 nombres

AutenticaciónToken Bearer

Soporte de IANo compatible

Las solicitudes por lotes no utilizan inferencia de IA.

askToAI y forceToGenderize no están disponibles. Para nombres en alfabetos no latinos o entradas que necesiten soporte de IA, utiliza el endpoint de nombre individual.

HDR

Headers HTTP obligatorios

Autoriza la solicitud por lotes

Content-Typeapplication/json

AuthorizationBearer YOUR_API_KEY

Cuerpo JSON de la solicitud

Parámetros

Campo	Tipo	Requisito	Descripción
`data`	object[]	Obligatorio	Array que contiene entre 1 y 100 registros de nombres.
`data[].name`	string	Obligatorio	Nombre que se analizará.
`data[].country`	string	Opcional	Código de país ISO 3166-1 alfa-2. Si no existe un resultado para el país, se utiliza el resultado global.
`data[].id`	string \| integer	Opcional	Identificador de tu registro, devuelto sin cambios para asociar cada resultado con su entrada.

Resultado alternativo por país

Si no hay coincidencias para el país enviado, GenderAPI devuelve el resultado global disponible. Utiliza valores ISO 3166-1 alfa-2 como DE, IT o US.

Payload de la solicitud

Crea el array data

JSON

{
  "data": [
    { "name": "Andrea", "country": "DE", "id": "123" },
    { "name": "andrea", "country": "IT", "id": "456" },
    { "name": "james", "country": "US", "id": "789" }
  ]
}

Ejemplos de código

Envía una solicitud con varios nombres

cURL

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

JavaScript

const data = [
  { name: "Andrea", country: "DE", id: "123" },
  { name: "andrea", country: "IT", id: "456" }
];

const response = await fetch("https://api.genderapi.io/api/name/multi/country", {
  method: "POST",
  headers: { "Content-Type": "application/json", "Authorization": "Bearer YOUR_API_KEY" },
  body: JSON.stringify({ data })
});

Respuesta 200

Asocia los resultados con tus registros

JSON

{
  "status": true,
  "used_credits": 3,
  "remaining_credits": 7265,
  "expires": 1717069765,
  "names": [
    { "name": "andrea", "q": "Andrea", "gender": "female", "country": "DE", "total_names": 644, "probability": 88, "id": "123" },
    { "name": "andrea", "q": "andrea", "gender": "male", "country": "IT", "total_names": 13537, "probability": 98, "id": "456" }
  ],
  "duration": "5ms"
}

Campos de respuesta

Campo	Tipo	Descripción
`status`	boolean	Indica si la solicitud por lotes se ha completado correctamente.
`used_credits`	integer	Créditos consumidos por todos los nombres enviados.
`remaining_credits`	integer	Créditos disponibles después de la solicitud.
`expires`	integer	Vencimiento del paquete como marca de tiempo UNIX.
`names`	object[]	Colección ordenada de resultados de estimación.
`names[].name`	string	Nombre normalizado utilizado para la estimación.
`names[].q`	string	Nombre enviado originalmente en la solicitud.
`names[].gender`	string \| null	Valor estimado: male, female o null.
`names[].country`	string	Código de país considerado para este resultado.
`names[].total_names`	integer	Número de muestras que respaldan el resultado.
`names[].probability`	integer	Confianza de la estimación expresada en porcentaje.
`names[].id`	string \| integer	Identificador de entrada devuelto para asociar registros.
`duration`	string	Tiempo total de procesamiento en el servidor.

Limita cada solicitud a 100 registros

Valida el array antes de enviarlo y utiliza un id único para asociar los registros de forma determinista. Divide los conjuntos de datos mayores en lotes de hasta 100 nombres.

Siguiente guía

Detecta el género a partir de un email

Solicitud individual por emailExtrae y analiza un nombre desde un email →Solicitud individual por nombreUtiliza soporte de IA para un nombre →