## 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 práticas em uma linguagem simples, análise em nível de frase com as frases mais difíceis destacadas e uma opção de aprovação/reprovação de grau alvo.
## Pontuações retornadas
- **Flesch Reading Ease** — 0–100. Quanto 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 através da razão de caracteres/palavras.
- **SMOG Index** — Nível de grau através da densidade de palavras polissilábicas.
## Casos de uso
Equipes de conteúdo, jurídico/acomodação, EdTech, ferramentas de SEO, pipelines de CMS, testes A/B de cópia.
## Endpoints
- `POST /api/analyze` — analise texto ou uma URL, com grau alvo opcional
- `POST /api/compare` — compare 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/12902/seo+optimization+readability+api/25677/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/12902/seo+optimization+readability+api/25678/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 ponto final `POST /api/analyze` retorna pontuações de legibilidade sugestões desgloses de frases e um resultado de grau objetivo opcional O ponto final `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 `wordCount`, `sentenceCount`, `scores` (que contém várias métricas de legibilidade), `suggestions` e `sentenceBreakdown` para análise detalhada. Cada pontuação inclui um valor de `score` e uma `interpretation`
O endpoint `POST /api/analyze` aceita parâmetros para o texto ou a URL a ser analisada e uma classificação alvo opcional O endpoint `POST /api/compare` requer dois textos para comparar Os usuários podem personalizar as solicitações fornecendo diferentes textos ou URLs
Os dados de resposta estão estruturados no formato JSON. Inclui um booleano `success`, seguido por estatísticas detalhadas como `textStats`, `scores`, `overall`, `suggestions` e `sentenceBreakdown`, permitindo que os usuários acessem e interpretem facilmente os resultados
Os casos de uso típicos incluem a otimização de conteúdo para SEO garantindo que os documentos legais sejam compreensíveis melhorando materiais educativos em EdTech e realizando testes A/B para cópias de marketing A API ajuda a melhorar a legibilidade em vários tipos de conteúdo
A precisão dos dados é mantida através do uso de fórmulas de legibilidade estabelecidas como o Flesch Reading Ease e o Gunning Fog Index Essas fórmulas são baseadas em pesquisa linguística e são amplamente reconhecidas na indústria garantindo resultados confiáveis
Os usuários podem esperar que os escores de legibilidade variem de 0 a 100 com escores mais altos indicando uma legibilidade mais fácil Os níveis de grau geralmente se alinham com os graus escolares dos EUA proporcionando uma compreensão clara da complexidade do texto
Os usuários podem aproveitar as pontuações de legibilidade para adaptar o conteúdo a públicos específicos usando sugestões para melhorar a clareza A análise das sentenças ajuda a identificar sentenças complexas o que permite revisões específicas para melhorar a legibilidade geral
Nível de serviço:
100%
Tempo de resposta:
1.249ms
Nível de serviço:
100%
Tempo de resposta:
2.921ms
Nível de serviço:
100%
Tempo de resposta:
1.867ms
Nível de serviço:
100%
Tempo de resposta:
114ms
Nível de serviço:
100%
Tempo de resposta:
1.512ms
Nível de serviço:
100%
Tempo de resposta:
233ms
Nível de serviço:
100%
Tempo de resposta:
78ms
Nível de serviço:
100%
Tempo de resposta:
1.130ms
Nível de serviço:
100%
Tempo de resposta:
1.332ms
Nível de serviço:
100%
Tempo de resposta:
3.726ms