{"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/12905/user+engagement+readability+api/25687/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/12905/user+engagement+readability+api/25688/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 Engajamento do Usuário 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 🎉)
Empresas líderes confiam em nós
## 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 por frase com as frases mais difíceis destacadas e opção de aprovação/reprovação de grau alvo.
## 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 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 A/B de copy.
## Endpoints
- `POST /api/analyze` — analisar texto ou uma URL, com grau alvo opcional
- `POST /api/compare` — comparar dois textos lado a lado
O endpoint `POST /api/analyze` retorna pontuações de legibilidade sugestões quebras de frases e um resultado de grau alvo opcional para um texto ou URL dados O endpoint `POST /api/compare` fornece uma comparação lado a lado de dois textos incluindo suas pontuações de Flesch 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, sentenças e caracteres), `scores` (várias métricas de legibilidade), `overall` (nível de grau médio e veredicto), `suggestions` e `sentenceBreakdown` A resposta de `compare` inclui os campos `text_a` e `text_b` com suas respectivas pontuações e um resumo de `comparison`
O endpoint `POST /api/analyze` aceita parâmetros como `text` (o conteúdo a ser analisado), `url` (a URL para obter e analisar) e um opcional `targetGrade` para avaliação de aprovado/reprovado O endpoint `POST /api/compare` requer dois textos para comparar
Os dados de resposta estão estruturados em formato JSON Para `analyze` inclui seções para estatísticas de texto pontuações de legibilidade avaliação geral sugestões e análise de frases Para `compare` apresenta seções separadas para as pontuações de cada texto e um resumo da comparação
Os casos de uso típicos incluem a criação de conteúdo para a otimização da legibilidade a simplificação de documentos legais a avaliação de material educativo a avaliação de conteúdo SEO e os testes A/B para cópias de marketing A API ajuda a garantir que o conteúdo seja acessível para o público pretendido
Os usuários podem utilizar as pontuações de legibilidade para ajustar a complexidade do conteúdo com base no público-alvo Sugestões podem orientar as revisões enquanto a análise das frases ajuda a identificar sentenças complexas que podem precisar de simplificação O recurso de comparação ajuda a selecionar a opção mais legível entre dois textos
A API utiliza fórmulas de legibilidade estabelecidas garantindo uma pontuação consistente baseada em princípios linguísticos Atualizações regulares e testes contra diversas amostras de texto ajudam a manter a precisão e confiabilidade nas pontuações fornecidas
Os usuários podem esperar que as pontuações oscilem entre 0 e 100 para a facilidade de leitura de Flesch com pontuações mais altas indicando uma legibilidade mais fácil Os níveis de grau geralmente se alinham com os graus escolares dos EUA e as sugestões frequentemente destacam áreas para melhorar especialmente para textos mais curtos