## O que faz
Avalia a legibilidade de qualquer texto ou URL em inglês. Retorna 5 pontuações de legibilidade padrão do setor, sugestões acionáveis em linguagem clara, análise em nível de frase com as frases mais difíceis sinalizadas e classificação de nível alvo opcional com aprovação/reprovação.
## Pontuações retornadas
- **Flesch Reading Ease** — 0–100. Maior = mais fácil de ler.
- **Flesch-Kincaid Grade** — Equivalente ao grau escolar nos EUA.
- **Gunning Fog Index** — Anos de educação necessários para entender.
- **Automated Readability Index (ARI)** — Nível de série via razão de caracteres/palavras.
- **SMOG Index** — Nível de série via densidade de palavras polissilábicas.
## Casos de uso
Equipes de conteúdo, jurídico/ compliance, EdTech, ferramentas de SEO, pipelines de CMS, testes A/B de cópias.
## Endpoints
- `POST /api/analyze` — analisa texto ou uma URL, com nível alvo opcional
- `POST /api/compare` — compara dois 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/12901/edtech+readability+improvement+api/25681/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/12901/edtech+readability+improvement+api/25682/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."}'
| Cabeçalho | Descrição |
|---|---|
Authorization
|
[Obrigatório] Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito. |
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
O endpoint `POST /api/analyze` retorna pontuações de legibilidade, sugestões, desagregações de frases e um resultado de nível de dificuldade opcional. O endpoint `POST /api/compare` fornece uma comparação lado a lado de dois textos, incluindo suas pontuações de legibilidade, níveis de grau e um resumo de qual texto é mais fácil de ler
Os campos-chave na resposta de `analyze` incluem `textStats` (contagens de palavras, frases e caracteres), `scores` (várias métricas de legibilidade), `overall` (nível de grau médio e veredicto), e `suggestions` A resposta de `compare` inclui os campos `text_a` e `text_b` com suas respectivas pontuações e um resumo de `comparison`
Os dados de resposta estão estruturados no formato JSON Para `analisar` inclui seções para estatísticas de texto pontuações de legibilidade avaliação geral sugestões e desagregações de sentenças A resposta de `comparar` contém seções separadas para as pontuações de cada texto e um resumo da comparação
O endpoint `POST /api/analyze` aceita parâmetros para o texto ou URL a ser analisado e uma nota alvo opcional. O endpoint `POST /api/compare` requer dois textos para comparação. Os usuários podem personalizar seus pedidos fornecendo textos ou URLs diferentes
Os casos de uso típicos incluem a criação de conteúdo para materiais educativos a simplificação de documentos legais a otimização de SEO e os testes A/B para cópias de marketing A API ajuda a garantir que o conteúdo seja acessível e apropriado para o público previsto
Os usuários podem aproveitar as pontuações de legibilidade para ajustar a complexidade do conteúdo de acordo com o público-alvo As sugestões podem orientar as revisões enquanto o desdobramento das frases ajuda a identificar áreas específicas para melhorar A função de comparação ajuda a selecionar a opção mais legível entre dois textos
A API utiliza fórmulas de legibilidade estabelecidas garantindo pontuações consistentes e confiáveis Atualizações regulares e testes contra amostras de texto diversas ajudam a manter a precisão e relevância nas avaliações de legibilidade
Os usuários podem esperar uma variedade de pontuações de legibilidade de 0 a 100 com pontuações mais altas indicando uma legibilidade mais fácil Os níveis de grau geralmente variam desde elementar até avançado refletindo a complexidade do texto As sugestões frequentemente destacam áreas de melhoria especialmente em textos mais curtos
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
888ms
Nível de serviço:
100%
Tempo de resposta:
670ms
Nível de serviço:
100%
Tempo de resposta:
637ms