API Google Search Console per il tuo stack
I dati di performance della tua Search Console, su un endpoint REST pulito.
Porta clic, impressioni, CTR e posizione media — per query, pagina e intervallo di date — direttamente da Google Search Console nel tuo prodotto, nella tua dashboard o nel tuo data warehouse. Collega GSC una volta dentro SEOcrawl AI, genera una chiave Bearer dalla tua dashboard e chiama la REST /v1 — senza costruirti l'OAuth di Google. È lo stesso livello dati canonico che alimenta il MCP di SEOcrawl AI, quindi i numeri tornano sempre. La copertura dell'indicizzazione e il controllo URL arrivano su REST a breve; via MCP sono già disponibili.
Risolvi una proprietà. Estrai i dati GSC.
Genera un token Bearer dalla tua dashboard e passalo nell'header Authorization. Risolvi una volta l'id della proprietà Search Console, poi interroga le sue performance via REST. La stessa chiave vale per l'API REST e per il server MCP.
URL base
https://api.seocrawl.ai/v1Header Authorization
Authorization: Bearer sca_live_your_token_hereTutte le metriche di Search Console, via REST
Clic, impressioni, CTR e posizione media — per query, pagina, intervallo di date e periodo su periodo. Ogni endpoint è legato a una proprietà: risolvi prima il suo id, poi leggi i suoi dati di Search Console. Questi gruppi GSC sono live in v1; copertura dell'indicizzazione e controllo URL oggi sono esposti dal MCP e arrivano su REST subito dopo.
Proprietà
Elenca le proprietà Search Console collegate al tuo account. Usa l'id di ogni proprietà nel path di tutti gli endpoint GSC.
- GET
/v1/propertiesLive
Performance
Clic, impressioni, CTR e posizione media totali su un intervallo di date — più la variazione rispetto al periodo precedente sulla stessa finestra.
- GET
/v1/properties/{id}/gsc/summaryLive - GET
/v1/properties/{id}/gsc/compareLive
Query
Le query di ricerca per cui compari, con le metriche per query — e lo storico giornaliero completo di qualsiasi keyword.
- GET
/v1/properties/{id}/gsc/top-keywordsLive - GET
/v1/properties/{id}/gsc/keywords/detailLive
Pagine
Gli URL che performano meglio con le loro metriche di Search Console — e il dettaglio giornaliero completo di qualsiasi pagina.
- GET
/v1/properties/{id}/gsc/top-pagesLive - GET
/v1/properties/{id}/gsc/pages/detailLive
Copertura dell'indicizzazione
Cosa indicizza davvero Google: stati di copertura e storico dell'indicizzazione. Oggi disponibile nel MCP; gli endpoint REST sono in rilascio.
- GET
/v1/properties/{id}/indexation/summaryPresto
Controllo URL
Ispezione URL per URL — copertura, ultima scansione e stato di indicizzazione di una singola pagina. Già disponibile via MCP; la REST arriva dopo.
- GET
/v1/properties/{id}/url-inspectionPresto
Dati reali di Search Console, pensati per i prodotti
Le tue performance reali in Google Search Console — non stime di terze parti — su un'API REST pulita, con auth Bearer e rate limit, che condivide un unico livello dati canonico con il MCP perché i numeri non si contraddicano mai.
Direttamente da Search Console
Clic, impressioni, CTR e posizione media estratti dalla tua proprietà GSC — i numeri veri che riporta Google, non stime modellate o scrapate. Risorse prevedibili, verbi standard, JSON tipizzato ed errori conformi agli RFC.
Nessun OAuth di Google da costruire
Collega Search Console una volta dentro SEOcrawl AI, poi leggila con un'unica chiave Bearer sca_live_. Dimentica il progetto su Google Cloud, la schermata di consenso e il refresh dei token: crei e revochi le chiavi dalla dashboard in pochi secondi.
Un unico livello dati canonico
Gli endpoint REST di GSC e i tool GSC del MCP sono fratelli sullo stesso provider, con la parità testata in CI. La tua dashboard e i tuoi agenti IA vedono sempre gli stessi clic, impressioni e posizioni.
Granularità per query e per pagina
Leggi i totali di una proprietà oppure scendi nel dettaglio: top query, top pagine, l'andamento giornaliero di una keyword o lo storico di un singolo URL — le stesse dimensioni che vedi in Search Console, raggiungibili via HTTP.
Confronto tra periodi incluso
Chiedi un range (last_7_days, last_28_days, last_3_months, last_year) o date from/to esplicite e ottieni il confronto tra periodi di serie — senza una seconda chiamata né calcoli di date lato client per far quadrare le variazioni.
Rate limit documentati
60 richieste al minuto e 1.000 all'ora per token, con risposte 429 + Retry-After chiare. I limiti REST sono un pool separato dal consumo del MCP: uno non lascia mai l'altro a secco.
Inizia in 3 passi
Da zero alla tua prima chiamata a Search Console in un paio di minuti.
Genera una chiave
Collega Search Console in SEOcrawl AI, apri Token API e genera un token Bearer. Copialo subito, una volta sola: inizia con sca_live_.
Risolvi una proprietà
Chiama GET /v1/properties con Authorization: Bearer sca_live_… per ottenere l'id (un UUID) della proprietà Search Console che vuoi leggere.
Estrai i dati GSC
Chiama /v1/properties/{id}/gsc/summary?range=last_28_days per i totali, oppure /gsc/top-keywords, /gsc/top-pages e gli endpoint /detail — e manda il JSON dritto nel tuo prodotto, nella tua dashboard o nel warehouse.
Tre modi per raggiungere i tuoi dati di Search Console
Gli stessi numeri GSC, superfici diverse: scegli quella adatta al tuo modo di costruire.
API REST
Per prodotti, dashboard e pipeline di dati. Auth Bearer, JSON tipizzato, rate limit. Sei già qui: l'API SEO completa aggiunge gli endpoint di posizionamento e visibilità nell'IA con la stessa chiave.
Server MCP
Per gli agenti IA: Claude, ChatGPT e qualsiasi client MCP interrogano i tuoi dati di Search Console in linguaggio naturale.
Esplora il MCPTerminale e CLI
Per script e CI/CD: governa i tuoi dati GSC da qualsiasi agente da terminale compatibile con MCP.
Vedi la CLIChi costruisce sull'API di Search Console
Team che vogliono dati reali di performance GSC dentro i propri sistemi.
Agenzie
Porta i dati di Search Console di ogni cliente in un portale su misura, in Looker Studio o nel tuo livello di reporting — una chiave, tutte le proprietà, senza export manuali da GSC.
SaaS e partner
Integra metriche di Search Console live nell'interfaccia del tuo prodotto. Dai ai tuoi utenti clic, impressioni e posizioni senza cablare tu l'API di Google.
Team dati
Porta clic, impressioni, CTR e posizione di GSC nel tuo warehouse in modo schedulato. Incrociali con i ricavi e costruisci i modelli che servono alle tue dashboard.
Sviluppatori
Automatizza il monitoraggio di query e pagine, lancia alert sui cali di posizione e collega i dati di Search Console alle app e ai flussi che già rilasci.
Domande frequenti
Questa è l'API ufficiale di Search Console di Google?
No. È l'API REST di SEOcrawl AI, autenticata con Bearer, costruita sui dati di Search Console che hai già collegato al tuo account. Colleghi GSC una volta dentro SEOcrawl AI e da lì leggi clic, impressioni, CTR e posizione con un'unica chiave sca_live_ — senza creare un progetto su Google Cloud, una schermata di consenso OAuth o un refresh dei token. I numeri sono i tuoi numeri reali di Search Console; l'API e l'autenticazione sono nostre.
Quali dati di Search Console posso estrarre oggi?
I totali su un intervallo di date (clic, impressioni, CTR, posizione media), i confronti tra periodi, le tue top query e top pagine con le metriche e il dettaglio giornaliero completo di una singola keyword o di una singola pagina — più l'elenco delle proprietà collegate. La copertura dell'indicizzazione e il controllo URL in tempo reale sono già disponibili via MCP; i rispettivi endpoint REST arrivano subito dopo. E se preferisci leggere l'account invece di interrogarlo, l'audit di Google Search Console copre gli stessi dati in un solo prompt.
Come mi autentico?
Con un token Bearer. Genera una chiave sca_live_ dalla tua dashboard e inviala come Authorization: Bearer <chiave> a ogni richiesta. Per il tuo account non c'è nessun balletto OAuth: solo l'header.
Quali intervalli di date sono supportati?
Ogni endpoint GSC accetta o un range (last_7_days, last_28_days, last_3_months o last_year) o una coppia from/to esplicita. L'endpoint gsc/compare restituisce la stessa finestra confrontata con il periodo precedente, così ottieni le variazioni senza una seconda chiamata.
Quali sono i rate limit?
60 richieste al minuto e 1.000 all'ora per token. Se li superi ricevi un 429 con header Retry-After. I limiti REST sono contati separatamente dal consumo del MCP, quindi i due non competono mai per lo stesso budget.
Sono la stessa chiave e gli stessi dati del MCP?
Sì. Lo stesso token sca_live_ autentica sia l'API REST sia il server MCP, ed entrambi leggono da un unico livello dati canonico — quindi i numeri di Search Console che ottieni via REST sono identici a quelli che i tuoi agenti IA vedono via MCP. Una credenziale, due superfici.
Pronto a costruire sui tuoi dati di Search Console?
Collega GSC una volta, genera una chiave Bearer dalla tua dashboard e fai la tua prima chiamata REST a Search Console in pochi minuti — oppure esplora il MCP per gli agenti IA.
