# Comparar Dos Textos

Descubre qué ha cambiado entre dos versiones de un contrato o un documento

- Página: https://herramient.as/comparar-textos
- Categoría: Texto
- Dónde se ejecuta: en el navegador, los datos no salen del dispositivo

Es una herramienta interactiva: se usa desde el navegador en https://herramient.as/comparar-textos.

## Uso por API

También se puede usar por API REST, con una clave en la cabecera `Authorization: Bearer htas_...`. Referencia completa: https://herramient.as/api-docs.md

### `POST /api/v1/tools/text/diff`

Compara dos textos y devuelve qué ha cambiado

Devuelve los tramos iguales, eliminados y añadidos, por líneas. El único endpoint de esta familia que no toca ficheros, así que no tiene ni límite de subida ni el 503 de los demás. Las tres opciones de normalización deciden qué cuenta como un cambio; ignore_whitespace viene activada porque es lo que se quiere casi siempre al comparar texto pegado de un PDF.

Consume 1 unidad de cuota.

**Parámetros**

| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `left` | string | sí | Texto original. Máximo 200.000 caracteres. Puede ser una cadena vacía (Ejemplo: `plazo de treinta días`) |
| `right` | string | sí | Texto modificado. Máximo 200.000 caracteres. Puede ser una cadena vacía (Ejemplo: `plazo de quince días`) |
| `ignore_case` | boolean | no | Tratar mayúsculas y minúsculas como iguales. Por defecto false |
| `ignore_whitespace` | boolean | no | Colapsar espacios repetidos y recortar los extremos. Por defecto **true** |
| `ignore_punctuation` | boolean | no | Descartar signos de puntuación. Por defecto false |

**Respuesta**

| Nombre | Tipo | Descripción |
|---|---|---|
| `identical` | boolean | Si no hay ninguna diferencia tras aplicar la normalización |
| `stats` | object | added, removed y equal: número de líneas de cada clase |
| `parts` | array | Los tramos en orden. Cada uno trae type (equal, added o removed) y las líneas en left y right |

**Errores**

- `400`: Falta left o right, no son texto, o superan los 200.000 caracteres

```bash
curl -X POST https://herramient.as/api/v1/tools/text/diff \
  -H "Authorization: Bearer htas_tu_clave_api" \
  -H "Content-Type: application/json" \
  -d '{"left":"plazo de treinta días","right":"plazo de quince días"}'
```

## Preguntas frecuentes

### ¿Para qué sirve comparar dos textos?

Para encontrar lo que ha cambiado entre dos versiones de un mismo documento sin leerlo entero: dos borradores de un contrato, el presupuesto de antes y el de después de pedir una rebaja, dos versiones de un trabajo, el correo que escribiste y el que te devolvieron corregido. Te marcamos en rojo lo que desaparece y en verde lo que se añade.

### ¿Marca solo las líneas o también las palabras?

Las dos cosas. Cuando una línea se ha modificado en vez de añadirse o quitarse, hacemos una segunda comparación dentro de ella y resaltamos solo las palabras que cambian: verás "treinta días" tachado y "quince días" en verde, no el párrafo entero marcado. Es lo que permite repasar un contrato largo de un vistazo.

### ¿Qué hacen las opciones de ignorar?

"Ignorar espacios de más" trata dos o más espacios seguidos como uno y descarta los del principio y el final, que es lo que quieres casi siempre al pegar desde un PDF; viene activada. "Ignorar mayúsculas" hace que "Cláusula" y "cláusula" cuenten como iguales. "Ignorar la puntuación" descarta comas, puntos y comillas: útil para comparar el contenido y no la maquetación, peligroso en un contrato, donde una coma cambia el sentido.

### ¿Se envían mis textos a algún servidor?

No. La comparación se calcula en tu navegador y no hay ninguna llamada de red: ni el contrato, ni el presupuesto, ni la nómina que pegues salen de tu equipo. Tampoco se guarda nada, así que al recargar la página se vacía.

### ¿Hay un límite de tamaño?

En la práctica es cómodo hasta unos cuantos miles de líneas por lado. Más allá, el cálculo exacto deja de ser viable en un navegador y pasamos a una comparación por bloques: sigue respondiendo, pero marca los cambios de forma más gruesa. Para documentos así, compara capítulo a capítulo.

### ¿Puedo comparar dos PDF?

No directamente, pero el camino está: pasa cada PDF por nuestra herramienta de extraer texto, copia los resultados y pégalos aquí. Con PDF generados por ordenador el texto sale exacto, así que la comparación es fiable.

## Herramientas relacionadas

- [Contador de Caracteres, Palabras y Párrafos](https://herramient.as/contador-caracteres-palabras): Analiza tu texto al instante: cuenta caracteres (con y sin espacios), palabras, párrafos, oraciones y calcula el tiempo de lectura. Perfecto para verificar límites de tweets, SMS, meta descripciones SEO y cualquier contenido con restricciones de longitud
- [Calculadora de Tiempo de Lectura](https://herramient.as/tiempo-lectura): Calcula cuánto tardas en leer un texto, un documento o un número de páginas
- [Extraer Texto de PDF o Imagen](https://herramient.as/extraer-texto-pdf-imagen): Saca el texto de un PDF escaneado o de una foto, con reconocimiento en español
- [Comprobar DNI, NIF y NIE](https://herramient.as/dni-nif-validator): Comprueba si un DNI, NIF o NIE es válido al instante. Validamos la letra de control con el algoritmo oficial.