Documentazione API

Integra FaktScan nel tuo sito o servizio

Verifica notizie, articoli, immagini e video direttamente dal tuo sistema — sito web, app, bot social o redazione. Risposte in JSON, pronte da mostrare ai tuoi utenti.

🔑 Come ottenere una chiave API

L'accesso è a pagamento con quota mensile di verifiche. Scrivi a massimiliano22@hotmail.it indicando l'uso previsto: riceverai una chiave del tipo fk_... da passare in ogni richiesta nell'intestazione X-API-Key.

Gli endpoint

Endpoint	Cosa fa	Invio
`POST /api/v1/verify-text`	Verifica un'affermazione o una notizia	JSON `{"claim": "..."}`
`POST /api/v1/verify-url`	Legge un articolo dal link e lo verifica	JSON `{"url": "https://..."}`
`POST /api/v1/verify-image`	Analisi deepfake/IA di un'immagine	file `multipart` oppure JSON `{"url": "..."}`
`POST /api/v1/verify-video`	Analisi deepfake di un video (max 50 MB)	file `multipart` oppure JSON `{"url": "..."}`
`GET /api/v1/usage`	I tuoi consumi del mese (gratuito)	—

Esempi

testoVerificare una notizia

curl -X POST https://faktscan.com/api/v1/verify-text \
  -H "X-API-Key: fk_LA_TUA_CHIAVE" \
  -H "Content-Type: application/json" \
  -d '{"claim": "Il governo ha approvato la nuova legge X"}'

articoloVerificare un articolo dal link

curl -X POST https://faktscan.com/api/v1/verify-url \
  -H "X-API-Key: fk_LA_TUA_CHIAVE" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://esempio.it/articolo-sospetto"}'

immagineVerificare un'immagine (da link o da file)

# da link (comodo per bot e social)
curl -X POST https://faktscan.com/api/v1/verify-image \
  -H "X-API-Key: fk_LA_TUA_CHIAVE" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://esempio.it/foto.jpg"}'

# oppure caricando il file
curl -X POST https://faktscan.com/api/v1/verify-image \
  -H "X-API-Key: fk_LA_TUA_CHIAVE" \
  -F "file=@foto.jpg"

consumiControllare la propria quota

curl https://faktscan.com/api/v1/usage -H "X-API-Key: fk_LA_TUA_CHIAVE"
# → {"cliente":"...","mese":"2026-08","usate":42,"quota":1000}

La risposta

Ogni verifica restituisce un JSON con questi campi principali:

{
  "affidabilita": 85,              // 0-100 = quanto risulta vera (media: 100 = autentica)
  "livello": "vero",               // vero | falso | fuorviante | non verificabile
                                   // (media: autentica | sospetta | manipolata)
  "sintesi": "Riassunto in 1-2 frasi del verdetto",
  "prove": [                       // per testo/articoli
    {"segno": "favore", "testo": "..."},
    {"segno": "contro", "testo": "..."}
  ],
  "segnali": [                     // per immagini/video
    {"tipo": "forense", "esito": "ok", "dettaglio": "..."}
  ],
  "fonti": [ {"nome": "...", "url": "https://..."} ],
  "consiglio": "Cosa verificare ancora",
  "condividi": "https://faktscan.com/v/abc123"   // pagina pubblica del risultato
}

Il campo condividi è una pagina già pronta da mostrare o linkare ai tuoi utenti.

Per immagini e video, quando disponibili, la risposta include anche exif (data di scatto, dispositivo, coordinate GPS, software di fotoritocco) e ricerca_inversa (dove l'immagine appare già online: utile a scoprire una foto autentica ma usata fuori contesto).

Errori e limiti

Codice	Significato
`401`	Manca l'intestazione `X-API-Key`
`403`	Chiave non valida o disattivata
`429`	Quota mensile esaurita
`400`	Richiesta non valida (il messaggio in `detail` spiega il perché)

Tempi tipici di risposta: 15–60 secondi per testo e articoli (ricerca web reale), 10–30 secondi per immagini, fino a 2 minuti per i video. Impostate un timeout di almeno 180 secondi.

Cache dei risultati

Se la stessa identica verifica (stesso testo, stesso link o stesso file) è già stata fatta nelle ultime 24 ore, la risposta arriva subito dalla cache, con il campo "cache": true in aggiunta — e non consuma la vostra quota. Il link condividi resta quello della verifica originale.

Widget per il tuo sito (gratuito)

Vuoi offrire la verifica ai tuoi lettori senza scrivere codice? Incolla questo nel tuo sito:

<iframe src="https://faktscan.com/widget"
        style="width:100%;max-width:440px;height:540px;border:0;border-radius:12px"
        title="FaktScan"></iframe>

Il widget usa il limite gratuito giornaliero dei visitatori. Per volumi maggiori o per integrare i risultati dentro le tue pagine, usa l'API con la tua chiave.