## 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 accionables en inglés sencillo, un desglose a nivel de oración con las oraciones más difíciles marcadas y un nivel de grado de aprobación/reprobación opcional.
## Puntuaciones devueltas
- **Facilidad de Lectura Flesch** — 0–100. Mayor = más fácil de leer.
- **Grado Flesch-Kincaid** — Equivalente al grado escolar de 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 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, pipelines de CMS, pruebas A/B de copias.
## Endpoints
- `POST /api/analyze` — analiza texto o una URL, con nivel de grado objetivo opcional
- `POST /api/compare` — compara 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/12896/readability+api/25667/analyze' --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/12896/readability+api/25669/compare' --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 desglose de oraciones sugerencias 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 qué texto es más fácil de leer
Los campos clave en la respuesta incluyen `éxito`, `textStats` (conteos de palabras, oraciones, caracteres), `puntuaciones` (Flesch, Gunning Fog, etc.), `general` (nivel de grado promedio y veredicto), `sugerencias`, y `desgloseDeOraciones` para un análisis detallado
Los datos de respuesta están estructurados en formato JSON Incluye un indicador de éxito de nivel superior seguido de secciones detalladas para estadísticas de texto puntuaciones de legibilidad evaluación general sugerencias de mejora y un desglose de oraciones individuales
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 de aprobado/reprobado El endpoint `POST /api/compare` requiere dos textos para comparación
Los usuarios pueden personalizar las solicitudes proporcionando texto específico o URL para análisis y estableciendo un nivel de grado objetivo en el endpoint `POST /api/analyze` Esto permite evaluaciones de legibilidad personalizadas basadas en las necesidades del usuario
Los casos de uso típicos incluyen la creación de contenido para blogs la simplificación de documentos legales el desarrollo de material educativo la optimización de SEO y las pruebas A/B para el copy de marketing para garantizar claridad y accesibilidad
La precisión de los datos se mantiene a través del uso de fórmulas de legibilidad establecidas como Flesch-Kincaid y Gunning Fog que son ampliamente reconocidas en la investigación lingüística La API también señala oraciones complejas para ayudar a los usuarios a identificar áreas de mejora
Si el texto de entrada es demasiado corto (menos de 100 palabras), la API puede devolver sugerencias que indican que los resultados son menos confiables. Los usuarios deben apuntar a textos más largos para obtener puntuaciones de legibilidad e información más precisas
Nivel de Servicio:
100%
Tiempo de Respuesta:
670ms
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:
0ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
1.658ms