# Estima el género en archivos Excel y CSV con GenderAPI

> Sube un archivo, comprueba las columnas sugeridas y elige nombres, correos o usuarios. Descarga los resultados en CSV y revisa los formatos, límites y tratamiento de datos.

Canonical HTML: https://www.genderapi.io/es/blog/determining-gender-of-names-in-excel-csv-with-gender-api

Last reviewed: 2026-09-28

## Procesa un archivo desde el panel de tu cuenta

La herramienta de archivos de GenderAPI lee la hoja, permite asignar la columna de nombres, correos o usuarios y prepara resultados CSV. Puedes utilizarla sin desarrollar una integración API.

Este flujo del panel es independiente de las solicitudes por lotes de REST V2. Un archivo no es una solicitud JSON V2 y sus límites de elementos y rutas de respuesta no se aplican directamente a este proceso.

- [Abrir la herramienta Excel y CSV](https://app.genderapi.io/csv)

## Formatos aceptados por el selector de archivos

El selector acepta un archivo cada vez. Si contiene varias hojas, elige la que procesarás y comprueba los valores leídos. Convierte los formatos no admitidos a uno de los listados antes de subirlos.

La complejidad del archivo, las filas, el método, los créditos y la carga del servicio influyen en el tiempo. Prueba un archivo representativo; no se garantiza un tamaño fijo ni un plazo de finalización.

| Formato | Extensión admitida |
| --- | --- |
| CSV | `.csv` |
| Excel | `.xls, .xlsx` |
| Apple Numbers | `.numbers` |
| OpenDocument | `.ods` |
| Valores separados por tabulaciones | `.tsv` |
| Texto | `.txt` |

## Revisa las sugerencias de columnas antes de procesar

- Prepara una copia que contenga solo los datos necesarios. Usa una columna de entrada con encabezado claro y, si procede, otra con códigos de país fiables de dos letras.
- Inicia sesión y abre la herramienta Excel y CSV. Selecciona la clave, el archivo y la hoja que utilizarás.
- Durante la configuración de la hoja, la herramienta puede enviar celdas de muestra para sugerir columnas mediante IA. Revisa personalmente el método y las columnas sugeridas antes de continuar.
- Elige nombres, correos o usuarios y verifica la entrada y el país opcional. Revisa los controles de IA y exportación disponibles en la pantalla.
- Inicia el proceso y sigue el progreso. No envíes repetidamente el mismo archivo solo porque todavía no haya terminado.
- Descarga el CSV cuando esté listo. Comprueba la correspondencia de filas y los registros identificados, desconocidos y fallidos. Conserva el original para comparar.

## Ajustes del procesamiento de archivos

| Ajuste | Tipo | Descripción |
| --- | --- | --- |
| Clave API | Credencial de cuenta | Cuenta cuyo saldo se utilizará para el proceso. |
| Archivo y hoja | Selección de archivo | Un archivo admitido y su hoja correspondiente. |
| Método | Opción | name, email o username. Revisa la sugerencia automática. |
| Columna de origen | Asignación de columna | Entrada que se analizará por fila; comprueba el encabezado y los ejemplos. |
| Contexto de país | Columna o ajuste opcional | Códigos conocidos de dos letras, cuando sean pertinentes. |
| IA y exportación | Controles actuales de la herramienta | Revisa los ajustes visibles antes de empezar; no son los parámetros ai_mode de V2. |

## Interpreta las columnas de resultados

El CSV exportado incorpora gender, country, probability y found_name. Comprueba los encabezados y la correspondencia de filas antes de importarlo en otro sistema. La salida es CSV aunque la entrada sea Excel.

Los resultados son estimaciones. Consérvalos separados de la declaración de género de la persona y de su país verificado.

- Antes de procesar todos los datos, revisa un resultado habitual, una entrada ambigua y una operación fallida.
- Una celda vacía, el texto null y un error de fórmula son valores diferentes. No ocultes los errores al normalizar resultados desconocidos.
- Usa expresiones neutrales para los casos inciertos y conserva la información aportada por la persona separada de las estimaciones.

| Salida | Tipo | Descripción |
| --- | --- | --- |
| Gender | Texto o valor sin resolver | Conserva male o female cuando el resultado sea correcto. Mantén los casos sin resolver como desconocidos y revisa los mensajes de error por separado. |
| Probability | Número, si está disponible | Es un indicador del complemento; no equivale al campo confidence de V2 ni a una tasa de exactitud medida sobre tus datos. |
| Country | Texto, si está disponible | Contexto devuelto por la consulta. Consérvalo por separado del país verificado del cliente. |
| Found / normalized name | Texto, si está disponible | Nombre utilizado o extraído durante el procesamiento. Revísalo cuando el correo o el usuario sean ambiguos. |

- [Indicadores de confianza y limitaciones](https://www.genderapi.io/es/accuracy-methodology)

## Planifica los créditos y las nuevas ejecuciones

Una cuenta gratuita registrada de GenderAPI dispone de 200 créditos diarios. Esto no garantiza 200 resultados identificados en cualquier flujo. Comprueba el saldo de la clave y las opciones actuales de la herramienta antes de empezar.

El complemento y las herramientas de archivos tienen sus propios procesos. Los límites de lotes, las opciones de IA y los campos de coste de REST V2 no se aplican automáticamente a estas herramientas. Volver a ejecutar o recalcular puede generar nuevas solicitudes y consumir créditos.

Empieza con una muestra pequeña, conserva los resultados completados y revisa las filas fallidas antes de repetirlas. Si solo necesitas reparar la exportación o la escritura en el destino, reutiliza los resultados existentes.

- [Planes y créditos de cuenta](https://www.genderapi.io/es/price)

## Ten en cuenta el análisis inicial y la conservación del archivo

Seleccionar una hoja puede enviar celdas de muestra para asignar columnas mediante IA antes del procesamiento final. No supongas que todos los datos permanecen en tu dispositivo hasta pulsar Iniciar. Elimina columnas innecesarias y revisa la política de privacidad antes de elegir un archivo con datos personales.

Si no necesitas la copia del espacio de trabajo después de descargarla, utiliza la opción de eliminación. La política vigente explica la retirada programada del sistema activo y la conservación en copias de seguridad; una fecha programada no demuestra que todas las copias ya se hayan borrado.

- [Política de conservación de archivos y consultas](https://www.genderapi.io/es/privacy-policy)

## Cuándo utilizar la API V2 directamente

Si necesitas controlar las opciones de IA o recibir estado, source, confidence_kind y usage para cada registro, configura una integración HTTP independiente. Sigue el contrato de solicitudes y respuestas V2: añadir nombres de campos V2 a una fórmula o al complemento no cambia su funcionamiento.

- [Parámetros de solicitud V2](https://www.genderapi.io/es/docs/v2/request-parameters)
- [Campos de respuesta V2](https://www.genderapi.io/es/docs/v2/responses)
- [Integración V2 con Python](https://www.genderapi.io/es/integrations/python)
- [Integración V2 con Node.js](https://www.genderapi.io/es/integrations/javascript)

## ¿Puedo subir un archivo XLSM?

El selector actual enumera CSV, XLS, XLSX, Numbers, ODS, TSV y TXT. Convierte XLSM a uno de esos formatos y comprueba los valores obtenidos.

## ¿Las sugerencias de columnas siempre son correctas?

No. Comprueba el tipo de entrada, los encabezados, la columna de origen y el país. Durante la configuración pueden enviarse muestras para sugerencias mediante IA.

## ¿Recibiré de vuelta el archivo Excel original?

El proceso documentado genera CSV. Revisa las columnas y las filas antes de trasladarlo al libro original o a otra herramienta.

## ¿Equivale a una solicitud batch de V2?

No. Es un trabajo de archivos con opciones y procesamiento propios del panel. Consulta la documentación batch de V2 si estás construyendo una integración JSON independiente.

## Documentación de referencia

- [Ficha oficial del complemento de Microsoft](https://app.genderapi.io/csv)
- [Documentación de solicitudes por lotes V2](https://www.genderapi.io/es/docs/v2/batch)
- [Planes y créditos de GenderAPI](https://www.genderapi.io/es/price)
- [Política de privacidad de GenderAPI](https://www.genderapi.io/es/privacy-policy)
- [Contrato de solicitudes V2](https://www.genderapi.io/es/docs/v2/request-parameters)
