## Qué hace
Califica la legibilidad de cualquier texto en inglés o URL. Devuelve 5 puntuaciones de legibilidad estándar de la industria, sugerencias prácticas en un lenguaje sencillo, desglose a nivel de oración con las oraciones más difíciles marcadas y nivel de grado objetivo opcional aprobado/reprobado.
## Puntuaciones devueltas
- **Facilidad de lectura Flesch** — 0–100. Más alto = más fácil de leer.
- **Grado Flesch-Kincaid** — equivalente al grado escolar de EE. UU.
- **Índice de niebla 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, tuberías CMS, pruebas de copia A/B.
## 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/12902/seo+optimization+readability+api/25677/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/12902/seo+optimization+readability+api/25678/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 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 incluyen `wordCount`, `sentenceCount`, `scores` (que contiene varias métricas de legibilidad), `suggestions` y `sentenceBreakdown` para un análisis detallado. Cada puntuación incluye un valor de `score` y una `interpretation`
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 comparar Los usuarios pueden personalizar las solicitudes proporcionando diferentes textos o URL
Los datos de respuesta están estructurados en formato JSON Incluye un booleano `success` seguido de estadísticas detalladas como `textStats` `scores` `overall` `suggestions` y `sentenceBreakdown` lo que permite a los usuarios acceder e interpretar fácilmente los resultados
Los casos de uso típicos incluyen la optimización de contenido para SEO, asegurando que los documentos legales sean comprensibles, mejorando materiales educativos en EdTech y realizando pruebas A/B para copias de marketing La API ayuda a mejorar la legibilidad en varios tipos de contenido
La exactitud de los datos se mantiene mediante el uso de fórmulas de legibilidad establecidas como el índice de facilidad de lectura de Flesch y el índice de niebla de Gunning Estas fórmulas se basan en la investigación lingüística y son ampliamente reconocidas en la industria, asegurando resultados confiables
Los usuarios pueden esperar que los puntajes de legibilidad varíen de 0 a 100 con puntajes más altos que indican una legibilidad más fácil Los niveles de grado generalmente se alinean con los grados escolares de EE UU proporcionando una comprensión clara de la complejidad del texto
Los usuarios pueden aprovechar las puntuaciones de legibilidad para adaptar el contenido a audiencias específicas utilizando sugerencias para mejorar la claridad. El desglose de las oraciones ayuda a identificar oraciones complejas lo que permite revisiones específicas para mejorar la legibilidad general
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.249ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
2.921ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.867ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
114ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
78ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.512ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
233ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.332ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.130ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.284ms