{"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/12899/content+marketing+readability+api/25675/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/12899/content+marketing+readability+api/25676/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 Lectura del Marketing de Contenidos 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 🎉)
Empresas líderes confían en nosotros
## Lo que hace
Evalúa la legibilidad de cualquier texto en inglés o URL. Devuelve 5 puntuaciones de legibilidad estándar de la industria, sugerencias utilizables en un inglés sencillo, desgloses a nivel de oración con las oraciones más difíciles señaladas, y un nivel de grado objetivo opcional de aprobado/reprobado.
## Puntuaciones devueltas
- **Facilidad de Lectura de Flesch** — 0–100. Más alto = más fácil de leer.
- **Grado de Flesch-Kincaid** — equivalente de 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, tuberías de CMS, pruebas A/B de copias.
## Puntos finales
- `POST /api/analyze` — analizar texto o una URL, con nivel de grado objetivo opcional
- `POST /api/compare` — comparar dos textos lado a lado
El endpoint `POST /api/analyze` devuelve puntajes 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 incluidos sus puntajes 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` (conteos 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 como `text` o `url` para análisis y un `targetGrade` opcional para evaluación El endpoint `POST /api/compare` requiere dos textos para comparación
Los datos de respuesta están estructurados en formato JSON con secciones para el estado de éxito estadísticas de texto puntuaciones de legibilidad evaluación general sugerencias y desgloses detallados de oraciones lo que permite un fácil análisis y parseo
Los casos de uso típicos incluyen la optimización de contenido para equipos de marketing la verificación de cumplimiento de documentos legales la evaluación de material educativo en EdTech y las pruebas A/B para contenido SEO para mejorar la legibilidad y el compromiso
Los usuarios pueden aprovechar los puntajes de legibilidad para ajustar la complejidad del contenido usar sugerencias para mejorar la claridad y analizar la estructura de las oraciones para identificar y revisar oraciones difíciles mejorando el compromiso general del contenido
La precisión de los datos se mantiene a través del uso de fórmulas y algoritmos de legibilidad establecidos asegurando que las puntuaciones reflejen evaluaciones confiables de la complejidad del texto basadas en estándares lingüísticos
Los usuarios pueden esperar patrones consistentes en las puntuaciones de legibilidad como puntuaciones más altas en el Flesch Reading Ease que indican textos más fáciles y una correlación entre niveles de grado más bajos y un lenguaje más simple que ayuda en la evaluación de contenido