## Lo que hace
Evalúa la legibilidad de cualquier texto en inglés o URL. Devuelve 5 puntuaciones de legibilidad estándar de la industria, sugerencias prácticas en inglés sencillo, un desglose a nivel de oración con las oraciones más difíciles marcadas y una opción de aprobación/reprobación de grado objetivo.
## Puntuaciones devueltas
- **Facilidad de Lectura Flesch** — 0–100. Mayor = más fácil de leer.
- **Grado Flesch-Kincaid** — Equivalente a grado escolar de EE. UU.
- **Índice de Neblina Gunning** — Años de educación necesarios para entender.
- **Índice de Legibilidad Automatizada (ARI)** — Nivel de grado a través de la proporción de caracteres/palabras.
- **Índice SMOG** — Nivel de grado a través de la densidad de palabras polisilábicas.
## Casos de uso
Equipos de contenido, legal/cumplimiento, EdTech, herramientas de SEO, tuberías de CMS, pruebas A/B de copias.
## Puntos finales
- `POST /api/analyze` — analiza texto o URL, con grado objetivo opcional
- `POST /api/compare` — compara dos textos lado a lado
{"success":true,"textStats":{"wordCount":18,"sentenceCount":2,"characterCount":85,"avgSentenceLength":9,"avgSyllablesPerWord":1.56,"polysyllabicWordCount":1,"polysyllabicWordPercentage":5.6},"scores":{"fleschReadingEase":{"score":66.1,"interpretation":"Standard","suitableFor":"Age 15–17"},"fleschKincaidGrade":{"score":6.3,"interpretation":"US Grade 6 reading level"},"gunningFog":{"score":5.8,"interpretation":"Very easy"},"automatedReadabilityIndex":{"score":5.3,"interpretation":"Roughly Grade 5 reading level"},"smogIndex":{"score":6.9,"interpretation":"Grade 7 reading level","note":"SMOG is most accurate with 30+ sentences"}},"overall":{"averageGradeLevel":6.1,"verdict":"Easy read","recommendedFor":"Most adults","plainEnglishScore":70},"suggestions":["Text is short (18 words). Readability scores are most reliable with 100+ words."],"sentenceBreakdown":{"all":[{"index":1,"sentence":"The quick brown fox jumps over the lazy dog.","wordCount":9,"fre":94.3,"grade":2.3,"complexity":"Easy"},{"index":2,"sentence":"This is a simple sentence for testing readability scores.","wordCount":9,"fre":37.9,"grade":10.2,"complexity":"Hard"}],"hardest":[{"index":2,"sentence":"This is a simple sentence for testing readability scores.","wordCount":9,"fre":37.9,"grade":10.2,"complexity":"Hard"},{"index":1,"sentence":"The quick brown fox jumps over the lazy dog.","wordCount":9,"fre":94.3,"grade":2.3,"complexity":"Easy"}]}}
curl --location --request POST 'https://zylalabs.com/api/12905/user+engagement+readability+api/25687/analizar' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"text": "The quick brown fox jumps over the lazy dog. This is a simple sentence for testing readability scores."}'
{"success":true,"text_a":{"fleschReadingEase":100,"gradeLevel":2.1,"verdict":"Very easy read","wordCount":11},"text_b":{"fleschReadingEase":0,"gradeLevel":19.4,"verdict":"Highly technical","wordCount":15},"comparison":{"moreReadable":"text_a","easeDifference":100,"gradeDifference":17.3,"summary":"text_a is easier to read by 100.0 Flesch points"}}
curl --location --request POST 'https://zylalabs.com/api/12905/user+engagement+readability+api/25688/comparar' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"text_a": "The cat sat on the mat. It was a sunny day.", "text_b": "The feline proceeded to position itself upon the horizontal surface whilst meteorological conditions remained favourable."}'
| Encabezado | Descripción |
|---|---|
Autorización
|
[Requerido] Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito. |
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
El punto final `POST /api/analyze` devuelve puntuaciones de legibilidad sugerencias desgloses de oraciones y un resultado de grado objetivo opcional para un texto o URL dado El punto final `POST /api/compare` proporciona una comparación lado a lado de dos textos incluidos sus puntajes de Flesch niveles de grado y un resumen de qué texto es más fácil de leer
Los campos clave en la respuesta de `analyze` incluyen `textStats` (conteos de palabras, oraciones y caracteres), `scores` (varias métricas de legibilidad), `overall` (nivel de grado promedio y veredicto), `suggestions` y `sentenceBreakdown`. La respuesta de `compare` incluye los campos `text_a` y `text_b` con sus respectivos puntajes y un resumen de `comparison`
El endpoint `POST /api/analyze` acepta parámetros como `text` (el contenido a analizar), `url` (la URL para obtener y analizar) y un opcional `targetGrade` para evaluación de aprobado/reprobado. El endpoint `POST /api/compare` requiere dos textos para comparar
Los datos de respuesta están estructurados en formato JSON Para `analizar` incluye secciones para estadísticas de texto puntuaciones de legibilidad evaluación general sugerencias y desglose de oraciones Para `comparar` presenta secciones separadas para las puntuaciones de cada texto y un resumen de la comparación
Los casos de uso típicos incluyen la creación de contenido para la optimización de la legibilidad la simplificación de documentos legales la evaluación de material educativo la evaluación de contenido SEO y las pruebas A/B para copias de marketing La API ayuda a garantizar que el contenido sea accesible para la audiencia prevista
Los usuarios pueden aprovechar los puntajes de legibilidad para ajustar la complejidad del contenido según las audiencias objetivo Las sugerencias pueden guiar revisiones mientras que el desglose de oraciones ayuda a identificar oraciones complejas que pueden necesitar simplificación La función de comparación ayuda a seleccionar la opción más legible entre dos textos
La API utiliza fórmulas de legibilidad establecidas asegurando una puntuación consistente basada en principios lingüísticos Actualizaciones regulares y pruebas contra diversas muestras de texto ayudan a mantener la precisión y fiabilidad en las puntuaciones proporcionadas
Los usuarios pueden esperar que las puntuaciones oscilen entre 0 y 100 para la facilidad de lectura de Flesch con puntuaciones más altas que indican una legibilidad más fácil Los niveles de grado generalmente se alinean con los grados escolares de EE UU y las sugerencias a menudo destacan áreas para mejorar especialmente para textos más cortos
Nivel de Servicio:
100%
Tiempo de Respuesta:
0ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
0ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
0ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
0ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
0ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
0ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
0ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
519ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
477ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
423ms