Índice de legibilidad
Que un párrafo se lea como un manual técnico o como un correo amigable no es cuestión de opinión, es medible. La API Índice de Legibilidad procesa su texto con fórmulas establecidas como Flesch Reading Ease y el índice Gunning Fog y devuelve los números exactos, para que sepa con precisión quién puede leer cómodamente lo que escribió.
Ejecutar — gratis
Corre en su navegador. Gratis y sin límite: sus datos no salen de esta página.
Convertir una intuición en un número
Decir 'esto se siente demasiado denso' es difícil de accionar; decir 'esto tiene un nivel de lectura universitario cuando su audiencia lee a nivel de secundaria' no lo es. Este endpoint existe para llenar esa brecha: equipos que escriben para audiencias generales, un grupo etario específico o un requisito regulatorio de nivel de lectura necesitan una medida objetiva que puedan rastrear en el tiempo y exigir como estándar, no una lectura subjetiva cada vez.
Qué devuelve una solicitud
Envía el texto a POST /text/readability, la tarea entra en cola y el motor calcula varias métricas establecidas sobre el mismo contenido: Flesch Reading Ease, Flesch-Kincaid Grade Level, el índice Gunning Fog y otras puntuaciones relacionadas que ponderan la longitud de las oraciones y la complejidad de sílabas o palabras de forma distinta. Los resultados, entregados por webhook firmado o enlace firmado, incluyen cada puntuación además de los conteos base, como la longitud promedio de oración y sílabas por palabra, para que vea por qué el resultado dio ese número y no solo el valor final.
Fórmulas de décadas atrás, todavía vigentes
Las fórmulas de legibilidad datan de mediados del siglo veinte, cuando investigadores como Rudolf Flesch y Robert Gunning las diseñaron para periódicos, formularios gubernamentales y manuales militares que debían entenderse por lectores con niveles educativos muy distintos. El cálculo es deliberadamente simple —longitud de oraciones y palabras como aproximación de la carga cognitiva—, y precisamente por eso ha resistido como referencia rápida y consistente décadas después, aunque el texto que mide haya pasado del papel a la web y las aplicaciones.
Dónde encaja dentro de la automatización
El análisis de legibilidad encaja naturalmente después de redactar o traducir contenido y antes de publicarlo, muchas veces como un filtro automático: rechazar o marcar cualquier página que supere un nivel de lectura objetivo para su audiencia. También combina bien con la revisión de textos, porque un párrafo puede estar impecable en gramática y aun así resultar demasiado denso para el lector al que apunta, algo que solo un análisis de legibilidad detecta.
Un precio plano y predecible
Este endpoint cuesta $0.002 por solicitud sin importar la extensión del documento, ya que el cálculo en sí es liviano comparado con tareas de texto generativo. No hay componente por palabra que rastrear, lo que facilita ejecutar análisis de legibilidad con libertad sobre toda una biblioteca de contenido sin necesidad de estimar conteos de palabras de antemano. Como en cualquier tarea, las solicitudes fallidas se reintentan hasta tres veces y nunca se cobran.
Qué puede hacer con ella
Cumplimiento de una guía de estilo editorial
Marque automáticamente cualquier página publicada que supere el nivel de lectura objetivo, manteniendo consistente una biblioteca de contenido grande a medida que se suman nuevos redactores.
Cumplimiento de lenguaje claro
Verifique formularios públicos, avisos o información de salud contra un nivel de lectura requerido antes de publicarlos, respaldando exigencias de lenguaje sencillo.
Ajuste de copy de correo y marketing
Evalúe asuntos y cuerpos de mensaje antes de un envío de campaña para confirmar que coinciden con el nivel de lectura al que realmente responde su audiencia.
Evaluación de material educativo
Verifique que el texto de una lección, un cuestionario o una guía de trabajo corresponda al grado escolar previsto antes de que llegue a los estudiantes.
Preguntas frecuentes
¿Qué fórmulas de legibilidad devuelve la API?
Devuelve Flesch Reading Ease, Flesch-Kincaid Grade Level, el índice Gunning Fog y otras métricas establecidas, todas calculadas sobre el mismo texto enviado.
¿La API de índice de legibilidad es gratis?
La herramienta de arriba es gratis en su navegador. La API es de pago: cada llamada se descuenta de su saldo prepago de ForHosting KIT — se recarga desde $10.00 (no caduca), se paga el precio publicado de cada solicitud, y una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens, y una tarea fallida no se cobra.
¿Cómo se calcula el precio del análisis de legibilidad?
Es una tarifa plana de $0.002 por solicitud sin cargo por palabra, ya que calcular estas métricas es computacionalmente más liviano que tareas que generan o reescriben texto.
¿Qué se considera un buen puntaje de Flesch Reading Ease?
Un puntaje más alto indica lectura más fácil, aproximadamente entre 90 y 100 para texto muy simple y por debajo de 30 para escritura académica o legal densa; lo que cuenta como 'bueno' depende por completo de su audiencia.
¿Puedo medir legibilidad en idiomas distintos al inglés?
Las fórmulas originales se diseñaron en torno a patrones de sílabas y oraciones del inglés, así que los resultados son más confiables para texto en ese idioma; conviene revisar la documentación para conocer la cobertura de idiomas vigente.
¿También corrige o reescribe mi texto?
No, solo evalúa el texto que envía; combínela con el endpoint de revisión de textos si además quiere sugerencias de edición para mejorar el puntaje.
¿Puedo analizar legibilidad en lote?
Sí, las solicitudes son asíncronas con entrega por webhook, así que puede evaluar un sitio o una biblioteca de documentos completa en un solo lote en vez de página por página.
¿Qué pasa si una solicitud de legibilidad falla?
Se reintenta automáticamente hasta tres veces; si sigue fallando recibe un error claro y nunca se le cobra por esa solicitud.
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, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/text/readability \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"…"}'const res = await fetch("https://api.kit.forhosting.com/text/readability", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/text/readability",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/text/readability", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/text/readability", 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
{
"text": "…"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "text.readability",
"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.
Límites
max_tokens | 20000 |
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. |