Detección de género masiva: de diez mil nombres a 10,000,000
Sube el archivo o llama a la API. En cualquiera de los dos casos conoces el precio antes de empezar, cada fila vuelve con las pruebas detrás y tu hoja de cálculo vuelve siendo tu hoja de cálculo.
La respuesta corta
- Hasta 10,000,000 filas en un CSV, 100,000 en un libro de Excel, o 100 nombres por petición a la API sin límite en el número de peticiones.
- Una consulta es un credit, comprado por adelantado, desde €0.35 por cada 1.000 nombres. Conoces el precio de todo el trabajo antes de empezarlo, en una factura con IVA, y los credits no caducan.
- Tu libro se devuelve, no se sustituye: estilos, fechas, fórmulas, celdas combinadas y las demás hojas sobreviven todas. Las columnas nuevas se insertan al lado de tus datos.
- Cada fila lleva una probabilidad y un número de muestras, así que puedes aceptar automáticamente las filas seguras y enviar solo el resto a revisión.
Dos formas de hacerlo, y cómo elegir
Una limpieza puntual y una base de datos enriquecida de forma continua son trabajos distintos. Los mismos datos responden a los dos, pero no deberías usar la misma vía para ambos.
| Pregunta | Subir un archivo | Llamar a la API |
|---|---|---|
| Mejor para | Una lista que ya tienes: un export del CRM, una lista de inscritos a un evento, una lista de correo | Nombres que llegan continuamente: registros, pedidos, leads importados |
| Quién lo hace | Cualquiera que tenga el archivo. Sin código. | Alguien que programe, una vez; después funciona solo |
| Límite de tamaño | 10,000,000 filas por CSV, 100,000 por libro de Excel | 100 nombres por petición, sin límite total |
| Qué recibes | El mismo archivo, con las columnas nuevas insertadas | JSON por nombre, para escribirlo donde quieras |
| Indicar el país | Asignar una columna de país en el asistente | Un país, una locale o una dirección IP por nombre |
| Mientras se ejecuta | El procesamiento sigue en segundo plano; recibes un correo con el enlace de descarga cuando termina | Sincrónico: una petición, una respuesta |
| Coste | Idéntico. Un credit por consulta en ambos casos, del mismo saldo. | |
Lo que cuesta realmente un trabajo grande
Se cobra por consulta, no por usuario ni por mes. Un nombre resuelto es un credit, tanto si pasó por un archivo como por la API, y la tarifa mejora a medida que sube el volumen.
| Nombres | Paquete publicado más barato que lo cubre, neto |
|---|---|
| 10,000 | €16.99 |
| 100,000 | €99.00 |
| 500,000 | €299 |
| 10,000,000 | pídenos un presupuesto |
Dos cosas que merece la pena hacer antes de comprar, porque las dos reducen lo que pagas: quitar duplicados de la lista —el mismo nombre dos veces cuesta dos credits— y eliminar las filas a las que en realidad no necesitas asignar género. Un nombre que nunca envías es gratis, y en un export real de clientes esos dos pasos suelen eliminar una parte sorprendente del archivo.
Las cifras actuales, todos los niveles y la opción de suscripción están en la página de precios. ¿Más grande que el paquete publicado más grande? Pregúntanos: es una conversación normal, no un caso especial.
Tu hoja de cálculo vuelve siendo una hoja de cálculo
Esta es la parte que normalmente se hace mal, así que conviene ser concretos. No extraemos tus datos, les asignamos género y te entregamos un archivo nuevo. Abrimos tu libro, escribimos las columnas nuevas dentro y te lo devolvemos.
- Se conservan estilos, formatos de número y de fecha, fórmulas y celdas combinadas: una fecha sigue siendo una fecha y una fórmula sigue siendo una fórmula.
- Los libros con varias hojas mantienen todas sus hojas. La subida revisa cada hoja, elige la primera con datos y te deja cambiar a otra con un selector de hoja.
- La fila de encabezados no tiene que ser la fila 1. Se detecta, y si la detección se equivoca haces clic en la fila correcta en la vista previa.
- Texto libre encima de la tabla, una tabla que empieza en la columna C, títulos de columna incompletos o repetidos: todo está cubierto, porque los exports reales son así.
Las columnas que se añaden junto a tus datos:
| Columna | Qué contiene |
|---|---|
ga_gender |
El resultado. Las etiquetas las eliges tú: male/female/unknown, h/m, 1/2, o lo que ya espere tu CRM. |
ga_accuracy |
Cuánto se inclina hacia un lado la distribución observada para este nombre, como número entero de 0 a 100. (La API devuelve lo mismo como probabilidad entre 0 y 1.) Columna opcional. |
ga_samples |
Sobre cuántas observaciones se apoya. Columna opcional, y la que hace auditable el resultado. |
ga_first_name |
El nombre que realmente hemos resuelto: útil cuando la entrada era un nombre completo o una dirección de correo. Columna opcional. |
El asistente de subida, paso a paso. Pruébalo con un archivo.
Por qué el número de muestras importa más a gran escala
Con diez nombres puedes revisar los resultados a ojo. Con un millón no, así que la pregunta pasa a ser sobre qué filas estás dispuesto a actuar sin comprobar.
Como cada fila lleva una probabilidad y el número de observaciones detrás, esa línea la trazas tú. Una habitual: aceptar todo a partir de ga_accuracy 90 con un número decente de muestras y apartar el resto para una persona o un saludo neutro. La alternativa —un único nivel de confianza aplicado a toda tu base de datos, elegido por otra persona— es la forma en que una lista acaba dirigiéndose mal a la gente a gran escala.
Los nombres que la base de datos no puede resolver dejan la columna de género vacía en lugar de rellenarla con una suposición. Con 9,124,598 nombres repartidos en 192 países esa es una parte pequeña de una lista normal, pero es una parte que puedes ver.
Si tu lista abarca varios países, dilo: el mismo nombre no es el mismo género en todas partes, y lo hemos escrito por separado.
Hacerlo con código
Para un enriquecimiento continuo, el endpoint por lotes acepta hasta 100 nombres por petición:
POST https://gender-api.com/v2/gender/by-first-name-multiple
[
{ "first_name": "Sandra", "country": "DE" },
{ "first_name": "Andrea", "country": "IT" }
]
Cada entrada responde de forma independiente, con su propia probabilidad, su número de muestras y su país, así que un lote es realmente un lote y no una única respuesta aplicada a varios nombres.
- Clientes oficiales para PHP, Python, Node, Java, Go, Ruby, Rust, Perl y .NET.
- Referencia completa de v2, una descripción OpenAPI y una colección de Postman.
- Una guía de implementación lista para usar en /skill.md, si prefieres pasarle el trabajo a un asistente de código.
- ¿Trabajas mejor en una hoja de cálculo o en un CRM? Hay integraciones listas para Excel, Google Sheets, Shopify, HubSpot, Salesforce, Zapier y más.
Las preguntas de compras
Una lista con nombres de clientes reales son datos personales, y un trabajo grande suele necesitar la aprobación de alguien que preguntará exactamente esto:
- Somos una empresa alemana; todos los servidores están en Alemania y los datos se procesan dentro de la UE.
- Los archivos subidos se almacenan cifrados y se eliminan a los diez días, o antes si los borras tú.
- Puedes solicitar un contrato de encargado del tratamiento desde tu cuenta.
- Los registros del servidor contienen el nombre enviado y se conservan 14 días, por motivos contables.
- Cada compra genera una factura con IVA en regla, y los NIF-IVA de la UE se tratan correctamente.
- Los credits de los paquetes de pago único no caducan, así que una única limpieza grande no necesita suscripción.
El panorama completo está en el resumen de privacidad.
Preguntas frecuentes
¿Cuántos nombres puedo procesar de una vez?
Hasta 10,000,000 filas en un solo archivo CSV, hasta 100,000 filas en un solo libro de Excel y 100 nombres por petición a través de la API, sin límite en el número de peticiones. Si necesitas más, divide el archivo o recorre la API en un bucle.
¿Cuánto cuesta un trabajo grande de detección de género?
Una consulta cuesta un credit, así que el precio queda fijado antes de empezar: el paquete publicado más barato que cubre 500.000 nombres son €299 netos. Por encima del paquete publicado más grande pasa a ser un presupuesto en lugar de un precio de tarifa. Compras los credits por adelantado, no caducan, y cada compra genera una factura con IVA.
¿Necesito a alguien que programe?
No. Subes el archivo, señalas la columna que contiene los nombres y descargas el archivo terminado, sin una línea de código. La API está para el caso en que el enriquecimiento tenga que ocurrir de forma continua y no una sola vez.
¿Volverá mi archivo de Excel intacto?
Sí. Estilos, formatos de número y de fecha, fórmulas, celdas combinadas y todas las demás hojas se quedan como estaban; las columnas nuevas se insertan en tu libro en lugar de generar un archivo nuevo a partir de tus datos.
¿Qué pasa con las filas que la base de datos no puede resolver?
La columna de género se queda vacía y el número de muestras te dice por qué. No se adivina nada para rellenar un hueco, así que puedes filtrar esas filas y decidir qué hacer con ellas en lugar de descubrir las suposiciones más tarde.
¿Una subida masiva cumple el GDPR?
Somos una empresa alemana, todos los servidores están en Alemania y los datos se procesan dentro de la UE. Los archivos subidos se almacenan cifrados y se eliminan a los diez días, y puedes solicitar un contrato de encargado del tratamiento desde tu cuenta.
¿Puedo probarlo antes de pagar?
Sí: cada cuenta incluye 100 consultas gratis al mes, suficiente para pasar una muestra de tu propia lista y comprobar los resultados antes de comprar credits para todo el archivo.
EMPIEZA CON UNA MUESTRA DE TU PROPIA LISTA
100 consultas gratis al mes, sin tarjeta de crédito: suficiente para pasar una parte del archivo real y comprobar los resultados antes de pagar por todo.
Subir un archivo CSV o Excel · Documentación de la API · Preguntar por un volumen mayor