Dati strutturati Schema.org
Veda i dati strutturati che una pagina consegna ai motori di ricerca: ogni blocco nascosto che descrive un prodotto, una ricetta o un articolo, così come l'ha scritto il sito. Nell'esempio, una pagina con un blocco valido e uno rotto dà 1 risultato. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Il KIT li estrae e te li mostra leggibili, così vedi esattamente cosa capiscono i motori di ricerca del tuo sito.
Il riassunto che molte pagine portano senza mostrarlo
Molte pagine descrivono se stesse alle macchine in un blocco che il visitatore non vede mai. Le schede prodotto indicano prezzo e disponibilità, le ricette elencano ingredienti e tempi di cottura, gli articoli riportano autore e data di pubblicazione. I proprietari dei siti aggiungono questi blocchi perché sono i motori di ricerca a chiederli per i risultati arricchiti. I metodi precedenti mescolavano le etichette con la pagina visibile, e un restyling poteva romperle. Il blocco separato si è imposto perché un nuovo layout non lo tocca e chi modifica i testi non ci si avvicina, ed è proprio questo a renderlo affidabile da leggere.
Che cosa riceve e chi lo usa
L'estrattore restituisce tutti i blocchi che trova, esattamente come pubblicati e ciascuno per conto suo, mentre un blocco danneggiato viene semplicemente lasciato fuori. Può indicare l'indirizzo della pagina oppure incollare l'HTML che ha già. I negozi online lo usano per tenere d'occhio i prezzi pubblicati dalla concorrenza, i ricercatori raccolgono collezioni di ricette e i consulenti SEO verificano che le schede prodotto di un cliente contengano davvero dati validi prima di cercare altrove il motivo delle stelline mancanti nei risultati.
A cosa servono davvero
Sono la base dei risultati arricchiti su Google: le stelline delle recensioni, il prezzo mostrato sotto il titolo, le domande a fisarmonica delle FAQ, l'orario di un evento. Se i dati strutturati sono corretti e completi, la tua pagina può occupare più spazio e attirare più clic; se sono incompleti o sbagliati, Google li ignora in silenzio. Questo strumento ti fa vedere cosa c'è davvero nel codice, non cosa pensi di aver messo.
Gratis nel browser, incollando l'HTML
La versione gratuita lavora sul tuo dispositivo: copi il codice sorgente della pagina e lo incolli qui, e i dati non escono dal browser. Per un controllo occasionale, la via gratis basta e avanza.
Domande frequenti
Che differenza c'è tra dati strutturati e meta tag?
I meta tag descrivono la pagina in generale (titolo, descrizione); i dati strutturati descrivono cosa contiene in modo specifico — un prodotto, un evento, una FAQ — così Google può mostrarli come risultati arricchiti.
È gratis o mi ritrovo un costo a sorpresa?
La modalità nel browser è gratuita e senza limiti.
I dati della pagina restano riservati?
Sì: se incolli l'HTML, l'estrazione avviene sul tuo dispositivo e nulla viene inviato ai nostri server. È la via più adatta se il contenuto è delicato.
Mi garantisce i risultati arricchiti su Google?
No, e diffida di chi lo promette. Ti mostra se i dati ci sono e sono corretti; se e come Google li usi resta una sua decisione.
I dati vengono restituiti così come li ha pubblicati il sito?
Sì. Ogni blocco torna esattamente come il sito l'ha pubblicato, senza reinterpretazioni, e più blocchi della stessa pagina arrivano separati invece di essere fusi. È ciò che serve per verificare che cosa dice davvero una pagina ai motori di ricerca.
Strumenti correlati
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/web/schema \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com"}'const res = await fetch("https://api.kit.forhosting.com/web/schema", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"url": "https://example.com"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/web/schema",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"url": "https://example.com"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/schema", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"url":"https://example.com"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"url":"https://example.com"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/schema", 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
{
"url": "https://example.com"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "web.schema",
"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.
Limiti
timeout_sec | 30 |
max_crawl_pages | 25 |
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. |
Note tecniche
I dati strutturati sono un riepilogo in codice, di solito in formato JSON-LD, che spiega a Google cosa c'è nella pagina: un prodotto con il suo prezzo, una ricetta, una FAQ, un evento.
Gratis nel browser, incollando l'HTML
Se invece ti serve far leggere direttamente un indirizzo al KIT — utile per passare in rassegna molte schede prodotto — quella modalità usa le API e costa $0.002 a richiesta.
Gli errori che salta fuori
Sono dettagli che bloccano i risultati arricchiti anche quando la pagina sembra a posto. Capita spesso: uno schema Product senza prezzo o senza disponibilità, un tipo dichiarato sbagliato, una recensione senza voto numerico, una FAQ con le domande ma senza le risposte. Vedendo il JSON-LD estratto capisci subito quale campo manca e cosa correggere, senza doverti fidare a occhio.
Casi di integrazione
Scheda prodotto e-commerce
Controlli la pagina di un articolo del negozio e verifichi che lo schema Product abbia nome, prezzo in euro e disponibilità: sono i campi che Google mostra nei risultati con le stelline.
FAQ in evidenza
Hai aggiunto una sezione di domande frequenti: controlli che lo schema FAQPage sia completo di domande e risposte, condizione per vederle comparire sotto il tuo link.
Attività locale
Per la pagina di Tecnoedil Verona S.n.c. verifichi lo schema LocalBusiness con indirizzo, telefono e orari: è ciò che alimenta la scheda dell'attività nelle ricerche locali.
Domande tecniche
Legge sia JSON-LD sia i microdati?
Sì. Estrae i dati strutturati in JSON-LD, il formato oggi consigliato, e riconosce anche i microdati inseriti direttamente nel codice HTML.