{"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/12904/accessibility+compliance+readability+api/25685/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/12904/accessibility+compliance+readability+api/25686/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 Cumplimiento de Accesibilidad Legibilidad 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 prácticas en inglés sencillo, desglose a nivel de oraciones con las oraciones más difíciles marcadas y una calificación de grado objetivo opcional de aprobado/reprobado.
## Puntuaciones devueltas
- **Flesch Reading Ease** — 0–100. Mayor = más fácil de leer.
- **Flesch-Kincaid Grade** — Equivalente al 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 relación carácter/palabra.
- **Í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` — analizar texto o una URL, con grado objetivo opcional
- `POST /api/compare` — comparar dos textos uno al lado del otro
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, incluidas 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` (Facilidad de Lectura de Flesch, Grado de Flesch-Kincaid, etc.), `overall` (nivel de grado promedio, veredicto) y `suggestions` La respuesta de `compare` incluye puntajes de `text_a` y `text_b`, veredictos 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 `comparar` organiza los datos en secciones separadas para 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 un grado objetivo opcional para la evaluación El endpoint `POST /api/compare` requiere dos textos para la comparación Los usuarios pueden personalizar las solicitudes proporcionando diferentes textos o URLs
Los casos de uso típicos incluyen la creación de contenido para la accesibilidad, verificaciones de cumplimiento legal, desarrollo de material educativo, optimización de SEO y pruebas A/B de copy de marketing La API ayuda a asegurar que el contenido sea comprensible para la audiencia prevista
Los usuarios pueden aprovechar las puntuaciones de legibilidad para ajustar la complejidad del contenido utilizar sugerencias para mejorar la claridad y analizar desgloses de oraciones para identificar oraciones desafiantes Estos datos ayudan a adaptar el contenido a audiencias específicas o estándares de cumplimiento
La API utiliza fórmulas y algoritmos de legibilidad establecidos para calcular puntuaciones asegurando consistencia y fiabilidad Actualizaciones regulares y pruebas contra estándares conocidos ayudan a mantener la precisión y calidad de los datos
Los usuarios pueden esperar que los puntajes de legibilidad varíen de 0 a 100 para la facilidad de lectura de Flesch con puntajes más altos que indican una legibilidad más fácil Los niveles de grado variarán según la complejidad del texto y las sugerencias generalmente resaltarán áreas para mejorar especialmente en textos más cortos