## 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 inglés claro y acciones, desglose a nivel de oración con las oraciones más difíciles señaladas y opción de nota objetivo de aprobado/reprobado.
## Puntuaciones devueltas
- **Facilidad de lectura de Flesch** — 0–100. Más alto = más fácil de leer.
- **Grado de Flesch-Kincaid** — equivalente al grado escolar de EE.UU.
- **Índice de Gunning Fog** — Años de educación necesarios para entender.
- **Índice de legibilidad automatizado (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 SEO, tuberías CMS, pruebas A/B de copy.
## Puntos finales
- `POST /api/analyze` — analizar texto o una URL, con nota 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/12906/academic+readability+analysis+api/25689/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/12906/academic+readability+analysis+api/25690/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 El punto final `POST /api/compare` proporciona una comparación lado a lado de dos textos, incluyendo puntuaciones de Flesch, niveles de grado y veredictos de legibilidad
Los campos clave incluyen `wordCount`, `sentenceCount`, `scores` (como `fleschReadingEase` y `gunningFog`), `overall` (con `averageGradeLevel` y `verdict`), y `suggestions` para mejorar Cada campo proporciona información sobre la legibilidad del texto
Los datos de respuesta están estructurados en formato JSON Para `POST /api/analyze`, incluye `textStats`, `scores`, `overall`, `suggestions` y `sentenceBreakdown` Para `POST /api/compare`, contiene secciones `text_a`, `text_b` y `comparison` para una evaluación de legibilidad fácil
El endpoint `POST /api/analyze` acepta parámetros como el texto o la URL a analizar y una calificación objetivo opcional para la evaluación El endpoint `POST /api/compare` requiere dos textos para comparar
Los usuarios pueden personalizar las solicitudes proporcionando textos específicos o URL para el análisis y estableciendo un nivel de grado objetivo en el endpoint `POST /api/analyze` Esto permite evaluaciones de legibilidad adaptadas a las necesidades del usuario
Los casos de uso típicos incluyen la creación de contenido para claridad, el cumplimiento de documentos legales, el desarrollo de material educativo, la optimización SEO y las pruebas A/B para textos publicitarios. La API ayuda a asegurar que los textos cumplan con los estándares de legibilidad para su audiencia objetivo
La precisión de los datos se mantiene a través del uso de fórmulas de legibilidad establecidas como Flesch y Gunning Fog que son ampliamente reconocidas en la investigación lingüística. Los algoritmos de la API están diseñados para proporcionar evaluaciones de legibilidad consistentes y confiables
Los usuarios pueden esperar patrones como puntuaciones más altas en el índice de facilidad de lectura de Flesch que indican textos más fáciles mientras que puntuaciones más bajas sugieren complejidad Además el nivel de grado promedio típicamente se correlacionará con las puntuaciones de legibilidad proporcionando una comprensión clara de la dificultad del texto
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:
637ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
670ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
0ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
689ms