Novità e migrazione dal vecchio sito
Il 12 novembre 2026 il servizio è passato dal vecchio software a una nuova applicazione. Questo è un riepilogo onesto di cosa è rimasto uguale e cosa cambia per chi usa l'API.
Cosa è rimasto uguale
- Indirizzo di base e percorsi dell'app Android (
/api/login,/api/seo/...) e dei siti/analisi (/api/websites,/api/audits,/api/archived-audits). - La busta di risposta (
data,meta,errors) e la forma dei campi dei siti e delle analisi. - Le chiavi API già emesse e le password degli utenti.
Cosa offre il nuovo servizio
- Percorso versionato
/api/v1, specifica OpenAPI (/api/v1/openapi.json) e questa documentazione con esempi di codice. - Search Console e Analytics dal vivo (
/search-console,/analytics) e le loro proprietà. - Spiegazioni in linguaggio semplice per punteggi e metriche (
/explain). - Protezioni: limite predefinito di 60 richieste al minuto per utente e blocco del login dopo 5 tentativi falliti.
- Controllo di salute pubblico (
/health).
Cosa cambia
POST /auditsora mette in coda l'analisi e risponde subito (201 conis_queued: true); prima eseguiva l'analisi durante la chiamata. Il tipohtmlnon è più supportato (422).- Il login restituisce una chiave nuova a ogni accesso; le chiavi non sono più salvate in chiaro (solo hash) e una chiave in chiaro non autentica più.
GET /projects/{id}restituisce le statistiche complete del progetto con fasce di posizione esclusive.- Nell'archivio delle analisi
uploader_idè sempre nullo. - Un piano che non include l'accesso API riceve 401 anche con la chiave giusta.
- Il vecchio indirizzo del cron HTTP
/gtg-seo-cronrisponde 410: le attività periodiche ora sono interne al servizio. /api-docsrimanda a/api/docs.
Cosa non è stato portato
- Pochi dati legacy non hanno una destinazione nel nuovo servizio (per esempio 7 "preferiti" dei siti).
- Alcuni vecchi indirizzi pubblici, come le pagine di documentazione API del vecchio sito, non esistono più.
