## 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 acionáveis em linguagem simples, análise nível de frase com as frases mais difíceis sinalizadas e aprovação/reprovação de nível de grau opcional.
## 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 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/ conformidade, EdTech, ferramentas de SEO, pipelines de CMS, testes de cópia A/B.
## Endpoints
- `POST /api/analyze` — analisa texto ou uma URL, com nível de grau 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/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."}'
| 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, análise de sentenças, sugestões e um resultado de grau alvo 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 incluem `sucesso`, `textStats` (contagens de palavras, frases, caracteres), `pontuações` (Flesch, Gunning Fog, etc.), `geral` (nível médio de graduação e veredicto), `sugestões` e `análiseDeFrases` para uma análise detalhada
Os dados da resposta estão estruturados no formato JSON Inclui um indicador de sucesso de nível superior seguido por seções detalhadas para estatísticas de texto pontuações de legibilidade avaliação geral sugestões de melhoria e uma análise de frases individuais
O endpoint `POST /api/analyze` aceita parâmetros como o texto ou URL a ser analisado e uma nota alvo opcional para avaliação de aprovação/reprovação O endpoint `POST /api/compare` requer dois textos para comparação
Os usuários podem personalizar as solicitações fornecendo texto específico ou URLs para análise e definindo um nível de escolaridade alvo no endpoint `POST /api/analyze` Isso permite avaliações de legibilidade personalizadas com base nas necessidades do usuário
Casos de uso típicos incluem criação de conteúdo para blogs simplificação de documentos legais desenvolvimento de materiais educacionais otimização de SEO e testes A/B para cópia de marketing para garantir clareza e acessibilidade
A precisão dos dados é mantida através do uso de fórmulas de legibilidade estabelecidas como Flesch-Kincaid e Gunning Fog, que são amplamente reconhecidas na pesquisa linguística A API também sinaliza sentenças complexas para ajudar os usuários a identificar áreas para melhoria
Se o texto de entrada for muito curto (menos de 100 palavras) a API pode retornar sugestões indicando que os resultados são menos confiáveis Os usuários devem buscar textos mais longos para obter pontuações de legibilidade e insights mais precisos
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:
670ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
477ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
519ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
1.076ms