## Lo que hace
Evalúa la legibilidad de cualquier texto o URL en inglés. Devuelve 5 puntuaciones de legibilidad estándar de la industria, sugerencias en un lenguaje sencillo y accionables, desglose a nivel de oración con las oraciones más difíciles señaladas y opción de aprobación/reprobación de grado objetivo.
## Puntuaciones devueltas
- **Flesch Reading Ease** — 0–100. Más alto = más fácil de leer.
- **Flesch-Kincaid Grade** — equivalente a un grado escolar de EE. UU.
- **Gunning Fog Index** — Años de educación necesarios para entender.
- **Automated Readability Index (ARI)** — Nivel de grado a través de la proporción de caracteres/palabras.
- **SMOG Index** — Nivel de grado a través de la densidad de palabras polivalentes.
## Casos de uso
Equipos de contenido, legal/cumplimiento, EdTech, herramientas SEO, tuberías CMS, pruebas A/B de copias.
## Puntos finales
- `POST /api/analyze` — analizar texto o una URL, con grado objetivo opcional
- `POST /api/compare` — comparar 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/12901/edtech+readability+improvement+api/25681/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/12901/edtech+readability+improvement+api/25682/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 puntajes de legibilidad sugerencias desgloses de oraciones y un resultado de grado objetivo opcional El punto final `POST /api/compare` proporciona una comparación lado a lado de dos textos incluidos sus puntajes de legibilidad niveles de grado y un resumen de cuál 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), y `suggestions` La respuesta de `compare` incluye los campos `text_a` y `text_b` con sus respectivos puntajes y un resumen de `comparison`
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 desgloses de oraciones La respuesta de `comparar` contiene secciones separadas para las puntuaciones de cada texto y un resumen de la comparación
El endpoint `POST /api/analyze` acepta parámetros para el texto o la URL a analizar y una calificación objetivo opcional El endpoint `POST /api/compare` requiere dos textos para la comparación Los usuarios pueden personalizar sus solicitudes proporcionando diferentes textos o URLs
Los casos de uso típicos incluyen la creación de contenido para materiales educativos, la simplificación de documentos legales, la optimización de SEO y las pruebas A/B para copias de marketing La API ayuda a garantizar que el contenido sea accesible y apropiado para la audiencia prevista
Los usuarios pueden aprovechar las puntuaciones de legibilidad para ajustar la complejidad del contenido según el público objetivo Las sugerencias pueden guiar las revisiones mientras que el desglose de las oraciones ayuda a identificar áreas específicas para mejorar 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 puntuaciones consistentes y confiables. Actualizaciones regulares y pruebas contra muestras de texto diversas ayudan a mantener la precisión y relevancia en las evaluaciones de legibilidad
Los usuarios pueden esperar una variedad de puntajes de legibilidad de 0 a 100 con puntajes más altos que indican una legibilidad más fácil Los niveles de grado suelen variar desde elemental hasta avanzado reflejando la complejidad del texto Las sugerencias a menudo resaltan áreas de mejora especialmente en 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:
670ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
637ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.594ms