Codificador Soundex
Robert y Rupert dan el mismo código, R163: se conserva la primera letra, los siguientes sonidos consonantes pasan a tres dígitos y los códigos cortos se completan con ceros, de modo que los nombres que suenan parecido coinciden. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Nombre
- Robert
- Código
- R163
- Normalizado
- ROBERT
- Longitud
- 6
El Soundex americano es el índice fonético clásico del censo de EE. UU. y de la genealogía que transforma un nombre personal o familiar en un código de cuatro caracteres: la primera letra conservada más tres dígitos que representan grupos de sonidos consonánticos. Nombres que suenan igual pero se escriben distinto—Robert y Rupert, Smith y Smythe—suelen compartir el mismo código Soundex, por eso archiveros, historiadores familiares y scripts de enlace de registros lo usan como primera clave de agrupación. Este codificador Soundex acepta una cadena de nombre no vacía, normaliza las letras latinas, aplica el mapa de dígitos estándar y las reglas de adyacencia, y devuelve el código con la forma normalizada usada al codificar.
Cómo el Soundex americano construye un código de letra más tres dígitos
Soundex empieza pasando el nombre a mayúsculas y conservando solo las letras latinas de la A a la Z; dígitos, espacios, guiones y puntuación se eliminan antes de codificar, de modo que un campo de formulario con espacios de más sigue funcionando. La primera letra de esa cadena normalizada se conserva tal cual y se convierte en el carácter inicial del código.
Cada letra posterior se mapea a un dígito o se descarta: B, F, P y V pasan a 1; C, G, J, K, Q, S, X y Z a 2; D y T a 3; L a 4; M y N a 5; R a 6. Las vocales A, E, I, O, U y la letra Y no generan dígito.
H y W tampoco generan dígito, pero a diferencia de las vocales no rompen una racha del mismo código numérico—así Ashcraft y Ashcroft se convierten ambas en A261 al colapsar el grupo S/C a través de la H. Las letras adyacentes que comparten el mismo dígito aportan solo una vez, por eso Jackson se convierte en J250 y no en una cadena más larga de doses. Tras reunir como máximo tres dígitos, las plazas que faltan se rellenan con ceros para que todo resultado exitoso tenga exactamente cuatro caracteres.
Para qué se usa Soundex en genealogía y registros
Genealogistas y proyectos de historia local usan un codificador Soundex para agrupar apellidos de censos y listas de pasajeros registrados con ortografía inconsistente. Las herramientas de CRM y de atención al cliente pueden agrupar apellidos parecidos antes de una revisión humana sin montar un motor completo de búsqueda difusa. Las demos de aula de algoritmos de indexación histórica necesitan un oráculo determinista que los estudiantes puedan invocar desde el navegador mientras el profesor muestra la tabla de dígitos en la pizarra.
Los cuadernos de limpieza de datos pueden emitir Soundex como una columna de características junto a minúsculas y Metaphone al construir features de resolución de entidades. Los fallos de validación nunca consumen saldo tras el rechazo del motor. Combínela con otras utilidades de texto solo cuando un paso posterior necesite otro esquema fonético o de cifrado; conserve el Soundex americano en su propia landing para que la intención SEO siga nítida y la guía sea honesta sobre lo que el código de cuatro caracteres puede y no puede hacer.
Qué puede hacer con ella
Agrupación de apellidos en genealogía y censos
Agrupe nombres de familia que suenan igual pero se escribieron distinto en registros históricos comparando códigos Soundex americano de cuatro caracteres.
Preemparejamiento difuso de nombres en CRM
Agrupe apellidos de clientes parecidos para revisión humana sin instalar un motor completo de resolución de entidades en cada envío de formulario.
Preguntas frecuentes
¿Cómo codifico un nombre con Soundex americano?
El campo code de la respuesta contiene el valor Soundex de cuatro caracteres (R163 para Robert).
¿Por qué Robert y Rupert comparten el mismo código?
Soundex mapea consonantes similares a los mismos dígitos y conserva solo la primera letra más tres dígitos, de modo que nombres que suenan igual suelen colisionar a propósito para el emparejamiento difuso.
¿El codificador Soundex es gratis?
La herramienta del navegador se ejecuta gratis en su dispositivo.
¿Soundex es lo mismo que Metaphone o el fonético OTAN?
No. Esta herramienta implementa solo Soundex americano (letra más tres dígitos). Metaphone, Double Metaphone y los alfabetos de deletreo OTAN son algoritmos y landings distintos.
¿Por qué el código Soundex siempre tiene cuatro caracteres?
Porque el método guarda la primera letra y como máximo tres dígitos. Si el nombre da menos, se rellenan los huecos con ceros, y si da más, el resto se descarta. Así todos los códigos se comparan con la misma longitud.
Herramientas relacionadas
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/enc/soundex \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Robert"}'const res = await fetch("https://api.kit.forhosting.com/enc/soundex", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"name": "Robert"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/soundex",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"name": "Robert"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/soundex", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"name":"Robert"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"name":"Robert"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/soundex", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"name": "Robert"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.soundex",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
Notas técnicas
La entrada vacía, el nombre ausente o una cadena sin letras A–Z falla con invalid_input para que quien llama pueda marcar formularios en blanco en lugar de inventar un código. La ruta gratuita del navegador y la API prepago comparten la misma lógica parse pura, de modo que demos escolares y tuberías de producción nunca discrepan entre Robert y Rupert.
Cómo el Soundex americano construye un código de letra más tres dígitos
Como la ruta es aritmética pura de caracteres sin red ni reloj, nombres idénticos siempre producen el mismo JSON para goldens de integración continua.
Contrato de entrada, marcas de vacío, forma de respuesta y errores habituales
No trate Soundex como cifrado ni como identificador único de persona: muchos apellidos no emparentados colisionan a propósito, y esa colisión es la ventaja del emparejamiento difuso, no un fallo. Prefiera esta landing cuando la intención de búsqueda sea codificador soundex, Soundex americano o código fonético de nombres; el deletreo fonético OTAN, Metaphone y las herramientas de cifrado generales responden a intenciones distintas y permanecen en páginas separadas. Las letras acentuadas fuera de la A–Z pura se eliminan junto con el resto de no letras, así que aporte una forma normalizada a ASCII si sus datos fuente usan diacríticos y necesita que esas letras participen. Envíe un cuerpo JSON con el campo de cadena obligatorio name igual al nombre de persona o familia que desea codificar. Se aceptan los alias text, input, value y s cuando los clientes reutilizan nombres de formulario antiguos o widgets de texto compartidos. Un name ausente, un valor que no sea cadena, una cadena de longitud cero, solo espacios o una cadena sin letras latinas elevan invalid_input y no se facturan en la API prepago—es la vía de marca de entrada vacía que promete el producto, expresada como error duro de validación y no como un cuerpo de éxito con código en blanco. En el éxito la respuesta incluye code (el valor Soundex de cuatro caracteres), method igual a american_soundex para que los enrutadores posteriores puedan ramificar sin adivinar formas, name que repite la cadena original, normalized con la secuencia A–Z en mayúsculas realmente codificada, empty siempre false en el éxito, y length igual al recuento de caracteres original antes del filtrado.
Dónde una API Soundex aporta valor y cómo funciona el precio
Use la herramienta gratuita en el navegador para comprobaciones puntuales y enseñanza; use la API KIT prepago cuando un backend, una función serverless o un SDK necesiten un contrato estable con saldo a $0.002 por elemento exitoso. Mantenga las cargas en longitudes de nombre ordinarias adecuadas a una llamada de ítem en un Worker isolate: esta herramienta es para nombres y etiquetas cortas, no para documentos de varios megabytes.
Casos de integración
Demos de índice fonético en el aula
Muestre a los estudiantes que Robert y Rupert comparten R163 mientras los formularios vacíos fallan con claridad, usando la misma ruta gratuita del navegador que la API.
Preguntas técnicas
¿Qué ocurre si el nombre está vacío?
La solicitud falla con invalid_input. La entrada ausente, en blanco o sin letras se marca como vacía y no se cobra en la API prepago.