## 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 simples, detalhamento por frase com as frases mais difíceis sinalizadas e aprovação/reprovação de grau alvo opcional.
## Pontuações retornadas
- **Flesch Reading Ease** — 0–100. 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 relaçã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/combate à conformidade, 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/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."}'
| 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 quebras de frases e um resultado de nível de escolaridade 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 escolaridade e um resumo de qual texto é mais fácil de ler
Os campos chave incluem `success`, `textStats` (contagens de palavras, frases e caracteres), `scores` (várias métricas de legibilidade), `overall` (nível de grau médio e veredito), `suggestions` e `sentenceBreakdown` para uma análise detalhada
O endpoint `POST /api/analyze` aceita parâmetros como `text` ou `url` para análise e um `targetGrade` opcional para avaliação O endpoint `POST /api/compare` requer dois textos para comparação
Os dados de resposta estão estruturados em formato JSON com seções para o estado de sucesso estatísticas de texto pontuações de legibilidade avaliação geral sugestões e desgloses detalhados de sentenças o que permite uma fácil análise e parseamento
Os casos de uso típicos incluem a otimização de conteúdo para equipes de marketing a verificação de conformidade de documentos legais a avaliação de material educativo em EdTech e os testes A/B para conteúdo SEO para melhorar a legibilidade e o engajamento
Os usuários podem aproveitar as pontuações de legibilidade para ajustar a complexidade do conteúdo usar sugestões para melhorar a clareza e analisar a estrutura das frases para identificar e revisar frases difíceis aumentando o engajamento geral do conteúdo
A precisão dos dados é mantida por meio do uso de fórmulas e algoritmos de legibilidade estabelecidos garantindo que as pontuações reflitam avaliações confiáveis da complexidade do texto baseadas em padrões linguísticos
Os usuários podem esperar padrões consistentes nas pontuações de legibilidade como pontuações mais altas no índice de facilidade de leitura de Flesch indicando textos mais fáceis e uma correlação entre níveis de série mais baixos e linguagem mais simples ajudando na avaliação de conteúdo
Nível de serviço:
100%
Tempo de resposta:
2.340ms
Nível de serviço:
100%
Tempo de resposta:
3.369ms
Nível de serviço:
100%
Tempo de resposta:
255ms
Nível de serviço:
100%
Tempo de resposta:
3.208ms
Nível de serviço:
100%
Tempo de resposta:
2.430ms
Nível de serviço:
100%
Tempo de resposta:
1.273ms
Nível de serviço:
100%
Tempo de resposta:
2.171ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
850ms
Nível de serviço:
100%
Tempo de resposta:
0ms
Nível de serviço:
100%
Tempo de resposta:
1.105ms
Nível de serviço:
100%
Tempo de resposta:
6.990ms
Nível de serviço:
91%
Tempo de resposta:
229ms
Nível de serviço:
100%
Tempo de resposta:
7.096ms
Nível de serviço:
100%
Tempo de resposta:
3.230ms
Nível de serviço:
100%
Tempo de resposta:
9.166ms
Nível de serviço:
100%
Tempo de resposta:
17.322ms
Nível de serviço:
90%
Tempo de resposta:
11.100ms
Nível de serviço:
100%
Tempo de resposta:
11.634ms
Nível de serviço:
100%
Tempo de resposta:
2.310ms