# API de género para nombres, correos y usuarios

> Estima el género probable a partir de un nombre, nombre completo, correo electrónico o nombre de usuario. GenderAPI.io V2 devuelve JSON estructurado con la fuente de la predicción, una puntuación de confianza y contexto de país opcional.

Canonical HTML: https://www.genderapi.io/es

Last reviewed: 2026-09-27

## Resumen

Estima el género probable a partir de un nombre, nombre completo, correo electrónico o nombre de usuario. GenderAPI.io V2 devuelve JSON estructurado con la fuente de la predicción, una puntuación de confianza y contexto de país opcional.

## Prueba una consulta V2 por nombre

Cada consulta consume 1 crédito. Si no hay una clave guardada o no se encuentra en el sistema, se utiliza la prueba de 10 créditos compartidos por IP cada 24 horas.

Respuesta V2 real obtenida el 1 de octubre de 2026. Envía la consulta para obtener un resultado en directo.

**Respuesta representativa; no es el resultado de una consulta en directo**

```json
{
  "data": {
    "input": {
      "type": "name",
      "value": "Lucía",
      "country": null
    },
    "name": "lucía",
    "gender": "female",
    "country": "ES",
    "confidence": 0.9950808151791989,
    "confidence_kind": "observed_frequency",
    "sample_count": 1423,
    "source": "dataset",
    "result_status": "identified",
    "reason": null,
    "country_source": "dataset",
    "match": {
      "name": "lucía",
      "method": "normalized",
      "scope": "global",
      "country": null
    }
  },
  "meta": {
    "request_id": "926facea-6c9c-456f-9ed1-e7815d1a31c7",
    "duration_ms": 12,
    "access": {
      "mode": "api_key",
      "reason": null
    },
    "usage": {
      "charged_credits": 1,
      "remaining_credits": 49999,
      "billing_status": "confirmed",
      "resets_at": null,
      "limit": null,
      "period_seconds": null
    }
  }
}
```

- [Abrir la demo en directo en la página HTML](https://www.genderapi.io/es#name-demo)

## Una API de género para nombres de todo el mundo

Consulta un registro, envía un lote o utiliza nuestras herramientas de hojas de cálculo. V2 distingue los resultados con predicción de aquellos sin predicción para que tu aplicación conserve la incertidumbre.

La cobertura varía según el nombre y el país: Global

Puntuación de confianza con su origen e interpretación: 0–1

Resultados y consumo de créditos en JSON: V2

Registros por lote con clave; 10 en la prueba por IP: 50

## Consulta un nombre o un nombre completo

Obtén una estimación con su puntuación de confianza y la fuente de la predicción. Cuando no hay una predicción disponible, V2 lo indica de forma explícita.

- Nombres y nombres completos

- Contexto de país opcional, cuando se conoce

- Nombres en alfabetos latinos y no latinos

- [Consultar la API V2 de nombres →](https://www.genderapi.io/es/docs/v2/gender-from-name)

## Aprovecha las pistas de nombre de una dirección de correo

Analiza las pistas de nombre presentes en formatos habituales de correo electrónico. Añade la estimación y su fuente a registros de CRM, clientes potenciales y análisis.

- Direcciones personales y profesionales

- Enriquecimiento de registros de CRM

- Confianza y fuente incluidas en la respuesta

- [Consultar la API V2 de correo electrónico →](https://www.genderapi.io/es/docs/v2/gender-from-email)

## Analiza nombres de usuario y alias

Busca nombres reconocibles dentro de un nombre de usuario. La opción forceToGenderize permite intentar una estimación incluso con alias que no contienen un nombre real; no garantiza obtener una predicción.

- Usuarios de redes sociales y comunidades

- Análisis opcional de alias

- Estado explícito cuando no hay predicción

- [Consultar la API V2 de nombres de usuario →](https://www.genderapi.io/es/docs/v2/gender-from-username)

## Procesa listas de nombres por lotes

Sube un archivo Excel o CSV, selecciona la columna de origen y descarga los resultados. Para enviar lotes desde tu aplicación, consulta la guía de solicitudes por lotes de V2.

- Archivos Excel y CSV

- Columnas de nombres, nombres completos o correos

- Contexto de país opcional

- [Consultar la guía de lotes de V2 →](https://www.genderapi.io/es/docs/v2/batch)

## Integra la API o conecta herramientas listas para usar

Empieza con la API REST o conecta GenderAPI.io con hojas de cálculo, plataformas de comercio electrónico y herramientas de automatización. Comprueba en cada guía qué versión de la API utiliza la integración.

- [Ver todas las integraciones](https://www.genderapi.io/es/integrations)

## Lo que necesitas saber antes de empezar

Consulta los tipos de búsqueda, la confianza, el acceso gratuito y el coste en créditos. Encontrarás los formatos de solicitud y los ejemplos de código en la documentación V2.

- [Ver todas las preguntas frecuentes →](https://www.genderapi.io/es/frequently-asked-questions)

### ¿Qué es GenderAPI.io?

GenderAPI.io estima el género probable a partir de un nombre, una dirección de correo electrónico o un nombre de usuario. V2 devuelve la predicción, la confianza, la fuente y el consumo de créditos en JSON. Son estimaciones basadas en patrones de nombres; no verifican la identidad de género declarada por una persona.

### ¿Cuándo utiliza inteligencia artificial V2?

Una consulta individual busca primero en el conjunto de datos. Si no encuentra una predicción, recurre a la IA de forma predeterminada. Este flujo estándar, incluido el recurso a la IA, consume 1 crédito en total. En las solicitudes por lotes, la IA está desactivada de forma predeterminada. Puedes configurar el modo de IA o activar forceToGenderize para analizar alias.

### ¿Cómo se interpretan la confianza y los resultados sin predicción?

El campo confidence de V2 contiene una puntuación entre 0 y 1, o null. confidence_kind distingue la frecuencia observada en el conjunto de datos de la confianza declarada por el modelo; la puntuación no garantiza la exactitud. Si no se obtiene una predicción, la respuesta incluye gender: null y result_status: unknown.

### ¿Cuántos créditos consume una consulta?

Una consulta estándar de V2 consume 1 crédito, incluido el recurso a la IA y los resultados procesados correctamente que no obtienen una predicción. El modo de IA always consume 2 créditos. Con forceToGenderize, una predicción del conjunto de datos cuesta 1 crédito; si se utiliza IA, el coste total es de 2 créditos. En los lotes, el coste se calcula por registro.

### ¿Puedo enviar varios registros en una sola solicitud?

Sí. V2 admite hasta 50 registros por lote con una clave de API válida, o hasta 10 en la prueba por IP. Una sola solicitud HTTP puede consumir varios créditos. Para archivos más grandes, también puedes utilizar las herramientas de Excel y CSV u otras integraciones.

### ¿Puedo probarlo gratis?

Sin una clave de API, la demo de V2 utiliza una prueba de 10 créditos por cada periodo de 24 horas, compartidos por quienes usan la misma dirección IP. Una cuenta gratuita dispone de 200 créditos diarios. Son créditos, no un número fijo de consultas: los modos de 2 créditos consumen el saldo más rápido.

### ¿Mi clave de API actual funciona con V2?

Sí. V1 y V2 comparten la misma clave de API y el saldo de la cuenta. Las integraciones V1 existentes siguen disponibles. Para nuevas integraciones, consulta la documentación V2: sus endpoints, campos de respuesta y formato de errores son distintos de los de V1.

## Prueba gratis GenderAPI.io

Crea una cuenta, prueba tus primeras consultas con 200 créditos diarios gratuitos y procesa archivos Excel o CSV cuando lo necesites.

- [Crear cuenta](https://app.genderapi.io/user/register)
- [Leer la documentación](https://www.genderapi.io/es/api-documentation)