{"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/12904/accessibility+compliance+readability+api/25685/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/12904/accessibility+compliance+readability+api/25686/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."}'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Conformidade de Acessibilidade Legibilidade API basta incluir seu token Bearer no cabeçalho Authorization.
| 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.
(Economize 2 meses com cobrança anual 🎉)
## 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 inglês simples, detalhamento em nível de frase com as frases mais difíceis sinalizadas e aprovação/reprovação de grau opcional.
## Pontuações retornadas
- **Facilidade de Leitura Flesch** — 0–100. Maior = mais fácil de ler.
- **Grau Flesch-Kincaid** — equivalente ao grau escolar dos EUA.
- **Índice de Nuvem de Gunning** — Anos de educação necessários para entender.
- **Índice de Legibilidade Automatizada (ARI)** — Nível de grau via relação de caracteres/palavras.
- **Índice SMOG** — 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, testes de cópia A/B.
## Endpoints
- `POST /api/analyze` — analisa texto ou uma URL, com grau alvo opcional
- `POST /api/compare` — compara dois textos lado a lado
O endpoint `POST /api/analyze` retorna pontuações de legibilidade, sugestões, divisões de sentenças 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 de `analyze` incluem `textStats` (contagens de palavras, frases, caracteres), `scores` (Facilidade de Leitura de Flesch, Grau de Flesch-Kincaid, etc.), `overall` (nível de grau médio, veredicto) e `suggestions` A resposta de `compare` inclui pontuações de `text_a` e `text_b`, veredictos e um resumo de `comparison`
Os dados de resposta estão estruturados em 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 frases A resposta `comparar` organiza os dados em seções separadas para 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 para avaliação O endpoint `POST /api/compare` requer dois textos para comparação Os usuários podem personalizar solicitações fornecendo textos ou URLs diferentes
Os casos de uso típicos incluem a criação de conteúdo para acessibilidade verificações de conformidade legal desenvolvimento de material educativo otimização de SEO e testes A/B de cópia de marketing A API ajuda a garantir que o conteúdo seja compreensível para o público previsto
Os usuários podem aproveitar os índices de legibilidade para ajustar a complexidade do conteúdo usar sugestões para melhorar a clareza e analisar a divisão das frases para identificar frases desafiadoras. Esses dados ajudam a adaptar o conteúdo a públicos específicos ou padrões de conformidade
A API utiliza fórmulas e algoritmos de legibilidade estabelecidos para calcular pontuações garantindo consistência e confiabilidade Atualizações regulares e testes contra padrões conhecidos ajudam a manter a precisão e qualidade dos dados
Os usuários podem esperar que os scores de legibilidade variem de 0 a 100 para a facilidade de leitura de Flesch com scores mais altos indicando uma legibilidade mais fácil Os níveis de grau variarão de acordo com a complexidade do texto e as sugestões geralmente destacarão áreas para melhorar especialmente em textos mais curtos