{"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/12900/legal+compliance+readability+api/25679/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/12900/legal+compliance+readability+api/25680/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 Legal 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 índices de legibilidade padrão da indústria, sugestões acionáveis em inglês simples, uma análise nível de sentença com as frases mais difíceis sinalizadas e uma aprovação/reprovação de nível de escolaridade opcional.
## Índices retornados
- **Facilidade de Leitura de Flesch** — 0–100. Maior = mais fácil de ler.
- **Grau Flesch-Kincaid** — equivalente ao grau escolar dos EUA.
- **Índice Gunning Fog** — Anos de educação necessários para entender.
- **Índice de Legibilidade Automatizado (ARI)** — Nível de série via proporção de caracteres/palavras.
- **Índice SMOG** — Nível de série via densidade de palavras polissilábicas.
## Casos de uso
Equipes de conteúdo, jurídico/compliance, EdTech, ferramentas de SEO, pipelines de CMS, testes A/B de cópias.
## Endpoints
- `POST /api/analyze` — analisar texto ou uma URL, com nível de escolaridade alvo opcional
- `POST /api/compare` — comparar dois textos lado a lado
O endpoint `POST /api/analyze` retorna pontuações de legibilidade sugestões desagregações de frases e um resultado de grau objetivo 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 `analyze` incluem `textStats` (contagens de palavras, frases e caracteres), `scores` (vários métricas de legibilidade), `overall` (nível de escolaridade médio e veredicto) e `suggestions`. A resposta `compare` inclui campos `text_a` e `text_b` com suas respectivas pontuações e um resumo de `comparison`
O ponto final `POST /api/analyze` aceita parâmetros como o texto ou a URL a ser analisada e uma avaliação opcional para a avaliação O ponto final `POST /api/compare` requer dois textos para a comparação Os usuários podem personalizar suas solicitações fornecendo textos ou URLs diferentes
Os dados de resposta estão estruturados em formato JSON Para `analisar` inclui seções para `sucesso` `estatísticasDoTexto` `pontuações` `geral` `sugestões` e `quebraDeFrases` A resposta de `comparar` contém seções de `sucesso` `texto_a` `texto_b` e `comparação` o que facilita o acesso a informações específicas
Casos de uso típicos incluem equipes de conteúdo melhorando a clareza dos documentos equipes de jurídico/conformidade garantindo a legibilidade de contratos aplicações de EdTech avaliando materiais educacionais e ferramentas de SEO otimizando conteúdo web A API também ajuda em testes A/B para eficácia de cópias
Os usuários podem aproveitar os índices de legibilidade para ajustar a complexidade do texto para seu público-alvo Por exemplo se um documento tiver uma pontuação muito alta no Índice de Flesch-Kincaid os usuários podem simplificar a linguagem com base nas sugestões fornecidas A divisão das frases ajuda a identificar e revisar frases complexas
A API utiliza fórmulas de legibilidade estabelecidas garantindo uma pontuação consistente e confiável Cada fórmula baseia-se em pesquisas linguísticas e o design da API permite uma análise em tempo real mantendo a precisão através de vários tipos e comprimentos de texto
Os usuários podem esperar que as pontuações de legibilidade variem conforme a complexidade do texto Por exemplo textos mais curtos podem dar pontuações menos confiáveis enquanto textos mais longos (mais de 100 palavras) fornecem avaliações mais precisas A API sinaliza frases complexas ajudando os usuários a identificar áreas para melhorar