{"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/12900/legal+compliance+readability+api/25679/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/12900/legal+compliance+readability+api/25680/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."}'
Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Legibilidad de Cumplimiento Legal API simplemente incluye tu token de portador en el encabezado de Autorización.
| 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.
(Ahorra 2 meses pagando anualmente 🎉)
## 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 claras y accionables en inglés, desglose a nivel de oración con las oraciones más difíciles señaladas, y una opción de aprobado/reprobado para el grado objetivo.
## Puntuaciones devueltas
- **Facilidad de Lectura de Flesch** — 0–100. Mayor = más fácil de leer.
- **Grado de Flesch-Kincaid** — Equivalente al grado escolar en EE. UU.
- **Índice de Niebla de Gunning** — Años de educación necesarios para entender.
- **Índice de Legibilidad Automatizado (ARI)** — Nivel de grado a través de la relació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, flujos de CMS, pruebas A/B de copias.
## Puntos finales
- `POST /api/analyze` — analiza texto o una URL, con grado objetivo opcional
- `POST /api/compare` — compara dos textos lado a lado
El endpoint `POST /api/analyze` devuelve puntuaciones de legibilidad sugerencias desgloses de oraciones y un resultado de grado objetivo opcional El endpoint `POST /api/compare` proporciona una comparación lado a lado de dos textos incluyendo sus puntuaciones 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, caracteres), `scores` (diversas métricas de legibilidad), `overall` (nivel promedio de grado 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`
El punto final `POST /api/analyze` acepta parámetros como el texto o la URL a analizar y una calificación opción para la evaluación El punto final `POST /api/compare` requiere dos textos para la comparación Los usuarios pueden personalizar sus solicitudes proporcionando diferentes textos o URL
Los datos de respuesta están estructurados en formato JSON Para `analizar` incluye secciones para `éxito` `estadísticasDelTexto` `puntuaciones` `general` `sugerencias` y `desgloseDeOraciones` La respuesta de `comparar` contiene secciones de `éxito` `texto_a` `texto_b` y `comparación` lo que facilita el acceso a información específica
Los casos de uso típicos incluyen equipos de contenido mejorando la claridad de documentos equipos legales/de cumplimiento asegurando la legibilidad de contratos aplicaciones de EdTech evaluando materiales educativos y herramientas de SEO optimizando contenido web La API también ayuda en pruebas A/B para la efectividad de copias
Los usuarios pueden aprovechar las puntuaciones de legibilidad para ajustar la complejidad del texto para su público objetivo Por ejemplo si un documento obtiene una puntuación demasiado alta en el Grado Flesch-Kincaid los usuarios pueden simplificar el lenguaje en función de las sugerencias proporcionadas El desglose de las oraciones ayuda a identificar y revisar oraciones complejas
La API emplea fórmulas de legibilidad establecidas asegurando una puntuación consistente y fiable Cada fórmula se basa en investigaciones lingüísticas y el diseño de la API permite un análisis en tiempo real manteniendo la precisión a través de varios tipos y longitudes de texto
Los usuarios pueden esperar que los puntajes de legibilidad varíen según la complejidad del texto Por ejemplo los textos más cortos pueden dar puntajes menos confiables mientras que los textos más largos (más de 100 palabras) proporcionan evaluaciones más precisas La API señala oraciones complejas ayudando a los usuarios a identificar áreas para mejorar