Nível de legibilidade SEO
O verificador de nível de legibilidade SEO converte o corpo da página em uma série escolar dos Estados Unidos e compara o resultado imediatamente ao nível de público escolhido por você.
Executar grátis
Em vez de interpretar um índice genérico, a equipe editorial recebe uma indicação direta de aprovação ou revisão, além das contagens de frases, palavras e sílabas que sustentam o resultado. O cálculo é determinístico, funciona sem rede e permite aplicar a mesma regra antes da publicação.
Escolha um nível que represente os leitores reais
Uma meta de legibilidade é mais útil quando representa as pessoas que devem agir na página, e não a formação do redator nem a complexidade do assunto. Páginas voltadas ao consumidor geralmente se beneficiam de uma meta menor, pois os visitantes leem rapidamente, podem usar uma tela pequena e não deveriam precisar de conhecimento especializado para entender o próximo passo. Um público profissional ou técnico pode justificar uma meta maior quando simplificar termos essenciais comprometeria o significado. Informe esse máximo em target_grade, de zero a vinte. O verificador trata a meta como limite superior e só sinaliza quando o nível calculado é maior. Assim, a resposta funciona como uma etapa editorial repetível: uma página exatamente na meta passa, enquanto outra acima dela exige revisão. Documente uma meta para cada família de conteúdo, como páginas de produto, artigos de suporte ou políticas. A consistência torna as comparações úteis e evita que o critério mude depois de conhecido o resultado. A meta não avalia a inteligência do leitor; descreve o esforço exigido pelo texto.
Entenda como o nível é calculado
A capacidade aplica a fórmula de nível Flesch–Kincaid ao corpo enviado. Ela conta frases encerradas por pontuação, palavras em inglês e sílabas estimadas, combinando o tamanho médio das frases com a média de sílabas por palavra. Frases longas e palavras com mais sílabas costumam elevar o nível. A saída inclui grade_level arredondado, target_grade efetivo, exceeds_target e as contagens e médias usadas. Esses dados tornam o resultado verificável: se o nível subir após uma edição, você poderá identificar uma mudança no tamanho das frases ou na complexidade das palavras. A pontuação final é obrigatória porque não existe média significativa sem frases; um texto sem frase completa retorna erro de entrada, em vez de inventar um denominador. As sílabas são estimadas por uma heurística determinística do inglês, portanto nomes próprios, abreviações e vocabulário incomum podem diferir de um dicionário. Essa limitação permanece previsível na comparação de versões. Envie o corpo visível e limpo, sem navegação, marcação ou código, pois textos de interface não relacionados podem distorcer o resultado da página.
Transforme o alerta em um fluxo editorial prático
Execute a verificação depois da edição estrutural e antes da aprovação final, quando ainda for possível alterar frases sem afetar um layout pronto. Se exceeds_target for falso, guarde o resultado com o rascunho como prova de que aquela versão cumpriu a regra do público. Se for verdadeiro, examine primeiro as frases mais longas, separe ideias acumuladas, troque nominalizações desnecessárias e explique termos especializados em linguagem clara. Envie novamente o corpo revisado e compare o nível e as médias auxiliares. Não busque um número menor removendo ressalvas essenciais nem transformando toda frase em fragmento. Fórmulas de legibilidade medem a forma linguística, não a exatidão, o tom, a acessibilidade, a persuasão ou a relevância de busca. Portanto, um resultado aprovado complementa a revisão humana, sem substituí-la. Na publicação automatizada, use o indicador booleano para solicitar revisão, não para reescrever ou rejeitar silenciosamente. O preço da API é US$ 0,002 por item. Como o algoritmo não usa rede, aleatoriedade ou relógio, entradas e metas idênticas sempre geram saídas idênticas.
Casos de uso
Aplicar um padrão de público no CMS
Verifique cada página com o nível definido para seu tipo e encaminhe ao editor somente os rascunhos acima da meta.
Comparar o original e a reescrita
Meça as duas versões com a mesma meta e use as médias para confirmar se a simplificação reduziu a dificuldade.
Auditar páginas de destino valiosas
Avalie textos de páginas importantes e priorize aquelas cujo nível supera o escolhido para clientes potenciais.
Perguntas frequentes
Qual fórmula de legibilidade é usada?
É usada a fórmula de nível Flesch–Kincaid, com contagem determinística de palavras e sílabas em inglês.
O que acontece quando o texto não tem frases?
A solicitação retorna erro de entrada, pois um nível baseado em frases exige pontuação de encerramento.
Um resultado igual à meta é sinalizado?
Não. exceeds_target só é verdadeiro quando grade_level é estritamente maior que target_grade.
A aprovação prova que o conteúdo é bom para SEO?
Não. Ela mede apenas a dificuldade de leitura; precisão, utilidade, intenção, acessibilidade e desempenho de busca exigem análise separada.
Quanto custa uma solicitação?
Cada item custa US$ 0,002. O cálculo determinístico é adequado para verificações editoriais recorrentes.
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/seo/readability-grade \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"Clear writing helps readers. Short sentences make ideas easier to follow."}'const res = await fetch("https://api.kit.forhosting.com/seo/readability-grade", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "Clear writing helps readers. Short sentences make ideas easier to follow."
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/seo/readability-grade",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "Clear writing helps readers. Short sentences make ideas easier to follow."
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/seo/readability-grade", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"Clear writing helps readers. Short sentences make ideas easier to follow."}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"Clear writing helps readers. Short sentences make ideas easier to follow."}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/seo/readability-grade", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"text": "Clear writing helps readers. Short sentences make ideas easier to follow."
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "seo.readability_grade",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |