# Documentación de GenderAPI.io V2

> Conecta tu aplicación a GenderAPI.io V2 en api.genderapi.io. Consulta nombres, correos o usuarios, procesa lotes mixtos e interpreta resultados, acceso y consumo de créditos.

Canonical HTML: https://www.genderapi.io/es/api-documentation

Last reviewed: 2026-09-27

## Haz tu primera solicitud

Utiliza GenderAPI.io V2 para estimar el género a partir de un nombre, nombre completo, correo electrónico o usuario. El servidor de la API es https://api.genderapi.io y la ruta base de V2 es /api/v2. Prueba el ejemplo GET en tu navegador y elige una guía para conectar tu aplicación.

La prueba gratuita proporciona 10 créditos por dirección IP cada 24 horas. Esta asignación se comparte con la v1. El siguiente ejemplo utiliza solo el conjunto de datos y deduce 1 crédito cada vez que envía la solicitud, incluso cuando actualiza la página. Con una clave API, las versiones 1 y 2 deducen créditos del mismo saldo de cuenta.

```text
https://api.genderapi.io/api/v2/gender?type=name&value=Marta&country=ES&ai_mode=off
```

- [Abre el ejemplo GET (usa 1 crédito de prueba)](https://api.genderapi.io/api/v2/gender?type=name&value=Marta&country=ES&ai_mode=off)
- [Configura tu clave API](https://www.genderapi.io/es/docs/v2/authentication#environment-setup)
- [Comprender la respuesta JSON](https://www.genderapi.io/es/docs/v2/responses)

## ¿Qué te gustaría hacer?

Elige el tipo de entrada para ver ejemplos ejecutables en cURL, JavaScript, Python, PHP, Java, C# y Go. Consulta las guías de resultados y créditos para gestionar las respuestas en tu aplicación.

- [Clave API y prueba gratuita](https://www.genderapi.io/es/docs/v2/authentication): Conecta tu clave de API o prueba la API gratis.
- [Parámetros de solicitud](https://www.genderapi.io/es/docs/v2/request-parameters): Elige campos de entrada, contexto del país y opciones de solicitud.
- [SDK oficiales](https://www.genderapi.io/es/docs/v2/sdks): Instala un cliente oficial para tu lenguaje de programación.
- [Género por nombre](https://www.genderapi.io/es/docs/v2/gender-from-name): Busca un nombre o un nombre completo.
- [Género por correo electrónico](https://www.genderapi.io/es/docs/v2/gender-from-email): Encuentra una señal de nombre en una dirección de correo electrónico.
- [Género por nombre de usuario](https://www.genderapi.io/es/docs/v2/gender-from-username): Utiliza un nombre de usuario o apodo como entrada.
- [Consultas por lotes](https://www.genderapi.io/es/docs/v2/batch): Procesa hasta 50 registros con clave de API, o 10 en la prueba por IP.
- [Validación del teléfono](https://www.genderapi.io/es/docs/v2/phone-validation): Verificar y formatear un número de teléfono.
- [Interpretar una respuesta](https://www.genderapi.io/es/docs/v2/responses): Lee predicciones, puntuaciones de confianza y resultados desconocidos.
- [IA y apodos](https://www.genderapi.io/es/docs/v2/ai-options): Elige cuándo usar la IA y cómo manejar los apodos.
- [Créditos y saldo](https://www.genderapi.io/es/docs/v2/credits-and-usage): Consulta tu saldo y lo que cuesta cada solicitud.
- [Errores y reintentos](https://www.genderapi.io/es/docs/v2/errors-and-retries): Resuelve errores y decide cuándo volver a intentarlo.
- [Migrar desde V1](https://www.genderapi.io/es/docs/v2/migration): Actualiza una integración existente usando la misma clave API.

## Referencia de endpoints

Combina https://api.genderapi.io con las rutas absolutas de esta tabla; por ejemplo, https://api.genderapi.io/api/v2/gender. Solo GET /gender admite parámetros de consulta. Envía JSON en las rutas POST; no utilices campos V1 como name, email, username o askToAI en una solicitud V2.

| Método | Ruta | Propósito |
| --- | --- | --- |
| GET | /api/v2 | Capacidades públicas y límites actuales; gratis. |
| GET | /api/v2/openapi.json | Contrato canónico OpenAPI; gratis. |
| GET | /api/v2/errors | Catálogo de errores legible por máquina; gratis. |
| GET | /api/v2/usage | Saldo actual de la cuenta o de la prueba por IP; sin coste. |
| GET / POST | /api/v2/gender | Un nombre, dirección de correo electrónico o nombre de usuario. |
| POST | /api/v2/gender/batch | Un lote ordenado de nombres, correos electrónicos, nombres de usuario o una combinación de ellos. |
| POST | /api/v2/phone/validate | Validar y formatear un número de teléfono. |