ForHosting KIT · SEO

Anteprima social

Verifica i tag Open Graph e Twitter Card di una pagina e ti dice come apparirà quando qualcuno la condivide su WhatsApp, Facebook, LinkedIn o X: titolo, descrizione e immagine dell'anteprima. Un link condiviso senza questi tag mostra un box grigio e vuoto, poco invitante; con i tag giusti diventa una scheda con immagine che invoglia al clic.

● StabileGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailApp prestoTelegram presto

Cos'è l'anteprima social e da cosa dipende

Quando incolli un link in una chat o su un social, la piattaforma non mostra l'URL nudo: cerca nella pagina i tag Open Graph per costruire un'anteprima con titolo, descrizione e immagine. Se quei tag mancano o sono incompleti, l'anteprima esce male — senza immagine, con un titolo sbagliato o del tutto vuota — e un link che appare povero riceve molti meno clic. Controllare i tag prima di diffondere una pagina è il modo per assicurarsi che si presenti come vuoi ovunque venga condivisa.

L'immagine è la parte che si sbaglia di più

Il tag og:image decide quale immagine appare nell'anteprima, ed è quello che dà più problemi: immagine assente, indicata con un percorso relativo invece che con l'URL completo, o di dimensioni sbagliate che la piattaforma ritaglia male. La misura consigliata è intorno a 1200×630 pixel. Lo strumento verifica che l'immagine sia dichiarata con un URL assoluto e ti mostra i valori di tutti i tag, così vedi subito se il problema è l'immagine mancante o un formato che verrà tagliato.

Open Graph e Twitter Card, gratis nel browser

Oltre ai tag Open Graph, che valgono per la maggior parte delle piattaforme, X usa le sue Twitter Card: spesso si integrano, ma conviene controllarle entrambe. Lo strumento elenca i tag presenti, segnala quelli mancanti o vuoti — titolo, descrizione, immagine, tipo — e ti dice cosa aggiungere. Incolli l'HTML e la verifica avviene nel browser: gratis, senza limiti. Il controllo diretto da URL passa dal servizio a $0.002 a pagina.

Casi d'uso

Prima di lanciare una campagna

Chi sta per promuovere una landing su LinkedIn e WhatsApp incolla l'HTML e controlla l'anteprima: scopre che manca l'og:image e che il titolo social è quello di default del tema. Li sistema prima di spendere in pubblicità su un link che appariva vuoto.

Blog con immagini che non appaiono

Un blog di cucina nota che i suoi articoli condivisi su Facebook escono senza foto: il controllo rivela che l'og:image usava un percorso relativo. Sostituito con l'URL assoluto, l'anteprima torna a mostrare la foto del piatto.

E-commerce che condivide le schede

Un negozio online verifica che le schede prodotto condivise su WhatsApp mostrino nome, prezzo nella descrizione e foto del prodotto: un'anteprima curata fa la differenza tra un link ignorato e uno che porta traffico.

Domande frequenti

Perché il mio link condiviso appare senza immagine?

Quasi sempre perché manca il tag og:image o è indicato con un percorso relativo invece che con l'URL completo. Le piattaforme social richiedono un indirizzo assoluto: lo strumento verifica proprio questo.

Che dimensioni deve avere l'immagine?

La misura consigliata è intorno a 1200×630 pixel, un rapporto che quasi tutte le piattaforme mostrano senza ritagli fastidiosi. Un'immagine troppo piccola o di forma diversa rischia di essere tagliata o ignorata.

Controlla anche le Twitter Card di X?

Sì: oltre ai tag Open Graph, che valgono per la maggior parte delle piattaforme, verifica anche le Twitter Card usate da X, così l'anteprima è a posto ovunque venga condivisa la pagina.

È gratis?

Sì, incollando l'HTML il controllo gira nel browser senza costi né limiti. A pagamento è solo la verifica diretta da URL, a $0.002 a pagina, comoda per controllare molte pagine già online.

I dati restano sul mio dispositivo?

Nella modalità gratuita sì: l'HTML che incolli viene analizzato nel browser e non lascia il dispositivo, quindi puoi controllare l'anteprima di una pagina prima ancora di pubblicarla.

Mostra come apparirà davvero l'anteprima?

Ti restituisce i valori dei tag che le piattaforme usano per costruire l'anteprima — titolo, descrizione, immagine — e segnala cosa manca, così sai in anticipo come si presenterà il link una volta condiviso.

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

POSThttps://api.kit.forhosting.com/seo/og-validate

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/og-validate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"url":"https://ejemplo.com"}'

const res = await fetch("https://api.kit.forhosting.com/seo/og-validate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "url": "https://ejemplo.com"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/seo/og-validate",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "url": "https://ejemplo.com"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/seo/og-validate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"url":"https://ejemplo.com"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"url":"https://ejemplo.com"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/seo/og-validate", 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://ejemplo.com"
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "seo.og_validate",
  "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

per richiesta$0.002

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.

Leggi la documentazione completa del KIT →

Esegui gratis nel browser