## 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 inglés sencillo que se pueden aplicar, desglose a nivel de oración con las oraciones más difíciles señaladas y una opción de aprobación/reprobación de grado objetivo.
## Puntuaciones devueltas
- **Flesch Reading Ease** — 0–100. Más alto = 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.
- **SMOG Index** — Nivel de grado a través de la densidad de palabras polisilábicas.
## Casos de uso
Equipos de contenido, legal/cumplimiento, tecnología educativa, herramientas de SEO, pipelines de CMS, pruebas A/B de copias.
## Endpoints
- `POST /api/analyze` — analizar texto o una URL, con grado objetivo opcional
- `POST /api/compare` — comparar dos textos uno al lado del otro
{"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/12903/technical+writing+readability+api/25683/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/12903/technical+writing+readability+api/25684/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 endpoint `POST /api/analyze` devuelve puntuaciones de legibilidad, sugerencias para mejorar, un desglose 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 incluyen `success`, `textStats` (conteo de palabras, oraciones y caracteres), `scores` (varias métricas de legibilidad), `overall` (nivel de grado promedio y veredicto), `suggestions` y `sentenceBreakdown` para un análisis detallado
El endpoint `POST /api/analyze` acepta parámetros para el texto o URL a analizar y una calificación 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 datos de respuesta están estructurados en formato JSON con claves de nivel superior que indican el estado de éxito seguidas de objetos anidados para estadísticas de texto puntuaciones de legibilidad evaluación general sugerencias y desgloses de oraciones lo que facilita su análisis y uso
Los casos de uso típicos incluyen la creación de contenido para claridad la simplificación de documentos legales la evaluación de material educativo la optimización SEO y pruebas A/B para copias de marketing ayudando a los equipos a asegurar que su comunicación sea efectiva y accesible
Los usuarios pueden aprovechar los puntajes de legibilidad para identificar oraciones complejas y mejorar la claridad del texto Las sugerencias pueden guiar las revisiones mientras que los desgloses de oraciones ayudan a identificar áreas específicas que necesitan simplificación mejorando la calidad general de la comunicación
La API emplea fórmulas de legibilidad establecidas asegurando puntajes consistentes y confiables Actualizaciones regulares y pruebas contra una variedad de muestras de texto ayudan a mantener la precisión y relevancia en las evaluaciones de legibilidad proporcionadas
Los usuarios pueden esperar una gama de puntuaciones de legibilidad de 0 a 100 con puntuaciones más altas que indican una legibilidad más fácil El nivel de grado promedio típicamente oscila entre 1 y 12 reflejando el nivel educativo requerido para entender el texto permitiendo evaluaciones rápidas de la complejidad 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:
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:
2.125ms
Nivel de Servicio:
100%
Tiempo de Respuesta:
519ms