## O que faz
Avalia a legibilidade de qualquer texto ou URL em inglês. Retorna 5 pontuações de legibilidade padrão da indústria, sugestões em inglês simples acionáveis, análise em nível de frase com as frases mais difíceis sinalizadas e uma avaliação de grau opcional de aprovação/reprovação.
## Pontuações retornadas
- **Flesch Reading Ease** — 0–100. Quanto maior = mais fácil de ler.
- **Flesch-Kincaid Grade** — Equivalente ao grau escolar dos EUA.
- **Gunning Fog Index** — Anos de educação necessários para entender.
- **Automated Readability Index (ARI)** — Nível de grau via razão de caracteres/palavras.
- **SMOG Index** — Nível de grau via densidade de palavras polissilábicas.
## Casos de uso
Equipes de conteúdo, jurídico/Compliance, EdTech, ferramentas de SEO, pipelines de CMS, teste de cópias A/B.
## Endpoints
- `POST /api/analyze` — analisar texto ou uma URL, com grau alvo opcional
- `POST /api/compare` — comparar 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/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."}'
| 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 de melhora, uma análise de frases e um resultado de nível de escolaridade opcional. O endpoint `POST /api/compare` oferece uma comparação lado a lado de dois textos, incluindo suas pontuações de legibilidade, níveis de escolaridade e um resumo de qual texto é mais fácil de ler
Os campos chave incluem `success`, `textStats` (contagem de palavras, frases e caracteres), `scores` (várias métricas de legibilidade), `overall` (nível de grau médio e veredicto), `suggestions` e `sentenceBreakdown` para uma análise detalhada
O endpoint `POST /api/analyze` aceita parâmetros para o texto ou URL a analisar e uma classificação alvo opcional para a avaliação O endpoint `POST /api/compare` requer dois textos para a comparação Os usuários podem personalizar as solicitações fornecendo diferentes textos ou URLs
Os dados da resposta estão estruturados no formato JSON com chaves de nível superior indicando o status de sucesso seguidas por objetos aninhados para estatísticas de texto pontuações de legibilidade avaliação geral sugestões e desagregações de frases facilitando a análise e utilização
Os casos de uso típicos incluem a criação de conteúdo para clareza a simplificação de documentos legais a avaliação de material educativo a otimização SEO e testes A/B para cópias de marketing ajudando as equipes a garantir que sua comunicação seja eficaz e acessível
Os usuários podem aproveitar as pontuações de legibilidade para identificar frases complexas e melhorar a clareza do texto As sugestões podem guiar as revisões enquanto os desmembramentos de frases ajudam a identificar áreas específicas que precisam de simplificação melhorando a qualidade geral da comunicação
A API utiliza fórmulas de legibilidade estabelecidas garantindo pontuações consistentes e confiáveis Atualizações regulares e testes com uma variedade de amostras de texto ajudam a manter a precisão e a relevância nas avaliações de legibilidade fornecidas
Os usuários podem esperar uma gama de pontuações de legibilidade de 0 a 100 com pontuações mais altas que indicam uma legibilidade mais fácil O nível de grau médio tipicamente oscila entre 1 e 12 refletindo o nível educacional necessário para entender o texto permitindo avaliações rápidas da complexidade do texto
Nível de serviço:
100%
Tempo de resposta:
211ms
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:
1.076ms
Nível de serviço:
100%
Tempo de resposta:
652ms
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:
1.608ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
280ms