Livello di leggibilità SEO
Il controllo del livello di leggibilità SEO converte il corpo della pagina in un livello scolastico statunitense e confronta subito il risultato con il livello del pubblico scelto da Lei.
Esegui gratis nel browser
Invece di interpretare un indice generico, la redazione riceve un'indicazione diretta di approvazione o revisione e i conteggi di frasi, parole e sillabe che la motivano. Il calcolo è deterministico, non usa la rete e permette di applicare la stessa regola prima della pubblicazione.
Scelga un livello che rappresenti i lettori reali
Un obiettivo di leggibilità è utile quando rappresenta le persone che devono agire sulla pagina, non l'istruzione dell'autore o la complessità dell'argomento. Le pagine per il grande pubblico spesso traggono vantaggio da un obiettivo più basso, perché i visitatori scorrono velocemente, possono leggere su uno schermo piccolo e non dovrebbero aver bisogno di conoscenze specialistiche per capire il passo successivo. Un pubblico professionale o tecnico può giustificare un valore maggiore quando semplificare una terminologia essenziale ne altererebbe il significato. Inserisca il massimo in target_grade, da zero a venti. Il controllo considera l'obiettivo un limite superiore e segnala il risultato solo se il livello calcolato lo supera. La risposta può quindi fungere da verifica editoriale ripetibile: una pagina pari all'obiettivo passa, una superiore richiede revisione. Documenti un obiettivo per ogni famiglia di contenuti, per esempio pagine prodotto, articoli di assistenza o informative. La coerenza rende significativi i confronti e impedisce di cambiare lo standard dopo aver visto il risultato. L'obiettivo non giudica l'intelligenza del lettore, ma descrive lo sforzo richiesto dalla prosa.
Comprenda come viene calcolato il livello
La capacità applica la formula del livello Flesch–Kincaid al corpo fornito. Conta le frasi concluse dalla punteggiatura, le parole inglesi e le sillabe stimate, quindi combina la lunghezza media delle frasi con le sillabe medie per parola. Frasi lunghe e parole con più sillabe tendono ad aumentare il livello. L'output comprende grade_level arrotondato, target_grade effettivo, exceeds_target e i conteggi e le medie usati. Questi dati rendono il risultato verificabile: se il livello sale dopo una modifica, Lei può capire se è cambiata la lunghezza delle frasi o la complessità lessicale. La punteggiatura finale è obbligatoria, perché senza frasi non esiste una media significativa; un testo privo di frasi complete restituisce quindi un errore di input. Le sillabe sono stimate con un'euristica inglese deterministica, perciò nomi propri, abbreviazioni e vocaboli insoliti possono differire da un dizionario. Il limite rimane prevedibile nel confronto tra bozze. Invii il corpo visibile e pulito, senza navigazione, markup o codice, perché testo estraneo può alterare il risultato della pagina.
Trasformi il segnale in un flusso editoriale pratico
Esegua il controllo dopo la revisione strutturale ma prima dell'approvazione finale, quando è ancora possibile modificare le frasi senza compromettere un layout finito. Se exceeds_target è false, conservi il risultato con la bozza come prova che quella revisione rispettava la regola del pubblico. Se è true, esamini prima le frasi più lunghe, separi le idee sovrapposte, sostituisca le nominalizzazioni inutili e definisca i termini specialistici con parole chiare. Invii nuovamente il corpo revisionato e confronti sia il livello sia le medie. Non insegua un numero minore eliminando precisazioni essenziali o riducendo ogni frase a un frammento. Le formule di leggibilità misurano la forma linguistica, non accuratezza, tono, accessibilità, persuasione o rilevanza di ricerca. Un risultato positivo affianca quindi il giudizio umano, senza sostituirlo. Nella pubblicazione automatizzata, usi l'indicatore booleano per richiedere una revisione, non per riscrivere o rifiutare in silenzio. Il prezzo dell'API è $0.002 per elemento. Poiché l'algoritmo non usa rete, casualità o orologio, input e obiettivi identici producono sempre lo stesso output.
Casi d'uso
Applicare uno standard del pubblico nel CMS
Controlli ogni pagina rispetto al livello del suo tipo e rinvii alla redazione solo le bozze oltre l'obiettivo.
Confrontare originale e riscrittura
Misuri entrambe le versioni con lo stesso obiettivo e usi le medie per verificare se la semplificazione ha ridotto la difficoltà.
Verificare le pagine di destinazione importanti
Valuti il corpo delle pagine strategiche e dia priorità a quelle che superano il livello scelto per i potenziali clienti.
Domande frequenti
Quale formula di leggibilità viene usata?
Viene usata la formula del livello Flesch–Kincaid con un conteggio deterministico di parole e sillabe inglesi.
Che cosa accade se il testo non contiene frasi?
La richiesta restituisce un errore di input, perché un livello basato sulle frasi richiede punteggiatura conclusiva.
Un risultato uguale all'obiettivo viene segnalato?
No. exceeds_target è true solo quando grade_level è strettamente maggiore di target_grade.
Il superamento prova che il contenuto è valido per la SEO?
No. Misura solo la difficoltà di lettura; accuratezza, utilità, intento, accessibilità e prestazioni di ricerca richiedono controlli separati.
Quanto costa una richiesta?
Ogni elemento costa $0.002. Il calcolo deterministico è adatto a controlli editoriali ripetuti.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
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)Esempio di richiesta
{
"text": "Clear writing helps readers. Short sentences make ideas easier to follow."
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "seo.readability_grade",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |