GSC_TOP_QUERIES
Ottieni le query di ricerca principali da Google Search Console ordinate per clic.
=GSC_TOP_QUERIES(startDate, endDate, [limit], [siteUrl])Restituisce: 2D array with columns: Query, Clicks, Impressions, CTR, Position
Panoramica
GSC_TOP_QUERIES recupera le query di ricerca più performanti direttamente dall'API di Google Search Console in Google Sheets. La funzione restituisce una tabella completa di metriche che include il testo della query, clic, impressioni, percentuale di clic (CTR) e posizione media per ogni parola chiave per cui si posiziona il tuo sito. I risultati sono ordinati per clic in ordine decrescente, rendendo facile identificare quali termini di ricerca generano più traffico verso il tuo sito.
Parametri
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
startDate | string | Sì | Data di inizio in formato "AAAA-MM-GG" o formato relativo come "-30d" per 30 giorni fa. |
endDate | string | Sì | Data di fine in formato "AAAA-MM-GG" o formato relativo come "-1d" per ieri. |
limit | number | No (100) | Numero massimo di righe da restituire. Predefinito 100, massimo 25000. |
siteUrl | string | No | URL della proprietà di Search Console. Se omesso, utilizza la proprietà connessa predefinita. |
Esempi
Query principali degli ultimi 30 giorni
Recupera le prime 100 query di ricerca degli ultimi 30 giorni utilizzando il formato di data relativo.
=GSC_TOP_QUERIES("-30d", "-1d")Output
| Query | Clicks | Impressions | CTR | Position |
| best project management tools | 1240 | 18500 | 6.7% | 3.2 |
| project management software | 980 | 22100 | 4.4% | 5.1 |
| free task manager | 870 | 15300 | 5.7% | 4.8 |
Prime 10 query per un mese specifico
Ottieni solo le prime 10 query per gennaio 2025.
=GSC_TOP_QUERIES("2025-01-01", "2025-01-31", 10)Output
| Query | Clicks | Impressions | CTR | Position |
| online invoice generator | 2100 | 31000 | 6.8% | 2.9 |
| free invoice template | 1850 | 28400 | 6.5% | 3.4 |
| invoice maker | 1620 | 25800 | 6.3% | 4.1 |
Esportazione completa per una proprietà specifica
Esporta fino a 25.000 query degli ultimi 90 giorni per una proprietà di dominio specifica di Search Console.
=GSC_TOP_QUERIES("-90d", "-1d", 25000, "sc-domain:example.com")Output
| Query | Clicks | Impressions | CTR | Position |
| example product review | 5400 | 82000 | 6.6% | 2.1 |
| example vs competitor | 3200 | 45000 | 7.1% | 3.5 |
| buy example online | 2800 | 38000 | 7.4% | 2.8 |
Panoramica rapida degli ultimi 7 giorni
Ottieni un'istantanea rapida delle prime 20 query della scorsa settimana per una revisione settimanale.
=GSC_TOP_QUERIES("-7d", "-1d", 20)Output
| Query | Clicks | Impressions | CTR | Position |
| meal prep ideas | 340 | 5200 | 6.5% | 4.2 |
| healthy lunch recipes | 290 | 4800 | 6.0% | 5.1 |
| quick dinner recipes | 265 | 4100 | 6.5% | 3.8 |
Casi d'Uso
Report settimanale delle prestazioni SEO
Le agenzie di marketing recuperano le query principali settimanalmente per tracciare le prestazioni delle parole chiave dei clienti, identificare miglioramenti nelle classifiche e riportare il ROI della ricerca organica in dashboard automatizzate.
Analisi dei gap di contenuto
I team editoriali analizzano le query principali per scoprire quali argomenti generano più traffico di ricerca e identificare parole chiave con impressioni elevate e CTR basso che necessitano di contenuti migliori o meta description.
Scoperta di prodotti e-commerce
I rivenditori online monitorano le query di ricerca principali per capire come i clienti trovano i loro prodotti, identificare ricerche di prodotti di tendenza e ottimizzare titoli e descrizioni delle pagine prodotto.
Benchmarking delle parole chiave dei competitor
Le aziende SaaS esportano le query principali mensilmente per confrontarle con gli elenchi di parole chiave dei competitor, identificare opportunità di posizionamento sul mercato e informare la strategia di ricerca a pagamento.
Rilevamento delle tendenze stagionali
Le aziende di viaggio confrontano le query principali in diversi periodi di tempo per identificare le tendenze di ricerca stagionali e pianificare i calendari editoriali intorno ai periodi di punta delle prenotazioni.
Suggerimenti Professionali
Usa date relative come "-30d" e "-1d" per creare dashboard che mostrano sempre gli ultimi dati senza dover aggiornare manualmente le celle delle date.
Combina con VLOOKUP o INDEX/MATCH contro l'esportazione di un periodo precedente per calcolare le variazioni settimana su settimana o mese su mese in clic e posizione.
Filtra i risultati per query dove le impressioni sono elevate ma il CTR è inferiore al 3% per trovare le tue migliori opportunità per migliorare title tag e meta description.
Esporta 25.000 righe trimestralmente e usa tabelle pivot per tracciare le tendenze delle parole chiave a coda lunga che potrebbero non apparire in una vista più breve delle prime 100.
Se gestisci più siti, usa il parametro siteUrl per recuperare i dati di ogni proprietà in schede separate dello stesso foglio di calcolo per un confronto facile.
Questa funzione è essenziale per i professionisti SEO che hanno bisogno di monitorare regolarmente le prestazioni delle parole chiave senza accedere manualmente a Google Search Console. Puoi specificare intervalli di date personalizzati utilizzando formati di data standard o date relative convenienti come "-30d" per gli ultimi 30 giorni o "-7d" per la scorsa settimana. Il parametro opzionale limit ti consente di controllare quante righe vengono restituite, da un elenco mirato delle prime 10 a un'esportazione completa di fino a 25.000 query.
Combinando GSC_TOP_QUERIES con altre formule del foglio di calcolo, puoi creare dashboard SEO potenti che si aggiornano automaticamente con gli ultimi dati. Traccia i cambiamenti nelle classifiche delle parole chiave settimana dopo settimana o mese dopo mese, identifica le query di tendenza e individua opportunità dove hai impressioni elevate ma CTR basso. I dati restituiti corrispondono esattamente a ciò che vedresti nel report Rendimento di Search Console, ma con la flessibilità aggiuntiva di essere all'interno di un foglio di calcolo dove puoi ordinare, filtrare, creare tabelle pivot e grafici dei dati come preferisci.
Errori Comuni
NOT_AUTHORIZED: Accesso alla proprietà di Search Console negatoCausa: L'account Google connesso a Unlimited Sheets non ha accesso alla proprietà di Search Console specificata.
Soluzione: Assicurati che il tuo account Google abbia almeno il permesso "Completo" sulla proprietà di Search Console. Vai su Search Console > Impostazioni > Utenti e permessi per verificare l'accesso. Se utilizzi una proprietà di dominio, assicurati di aver verificato la proprietà.
INVALID_DATE: La data di inizio deve essere precedente alla data di fineCausa: La startDate è successiva alla endDate, o una delle date è in un formato non valido.
Soluzione: Verifica che le tue date siano in formato "AAAA-MM-GG" e che la data di inizio sia cronologicamente precedente alla data di fine. Quando usi date relative, ricorda che "-30d" significa 30 giorni fa (prima) e "-1d" significa ieri (dopo).
PROPERTY_NOT_FOUND: Nessuna proprietà di Search Console connessaCausa: Non è stata impostata alcuna proprietà di Search Console predefinita e non è stato fornito alcun siteUrl.
Soluzione: Fornisci esplicitamente il parametro siteUrl (es. "sc-domain:example.com") oppure connetti una proprietà predefinita tramite la barra laterale di Search Console di Unlimited Sheets (Estensioni > Unlimited Sheets > Search Console).
Domande Frequenti
Google Search Console conserva i dati per gli ultimi 16 mesi. Puoi utilizzare qualsiasi intervallo di date all'interno di quella finestra. Le date possono essere specificate in formato "AAAA-MM-GG" o come date relative come "-30d" (30 giorni fa), "-7d" (7 giorni fa) o "-1d" (ieri). I dati più recenti disponibili sono tipicamente di 2-3 giorni fa a causa del ritardo di elaborazione di Google.
Puoi recuperare fino a 25.000 query per richiesta impostando il parametro limit. Il valore predefinito è 100 se non viene specificato alcun limite. Per siti con più di 25.000 query in classifica, considera l'utilizzo di GSC_QUERY con la dimensione data per suddividere i dati su più intervalli di date.
I risultati sono sempre ordinati per clic in ordine decrescente, mostrando le query con più traffico per prime. Se hai bisogno di un ordinamento diverso, puoi utilizzare la funzione SORT di Google Sheets sui dati restituiti, ad esempio =SORT(GSC_TOP_QUERIES("-30d", "-1d"), 5, TRUE) per ordinare per posizione crescente.
Il siteUrl deve corrispondere esattamente alla tua proprietà di Search Console. Per le proprietà di dominio usa "sc-domain:example.com". Per le proprietà con prefisso URL usa l'URL completo come "https://www.example.com/". Se omesso, la funzione utilizza la proprietà predefinita che hai connesso durante la configurazione.
Piccole discrepanze sono normali e possono verificarsi a causa di campionamento dei dati, differenze di fuso orario o arrotondamenti. I dati API e l'interfaccia di Search Console utilizzano lo stesso dataset sottostante, ma i metodi di aggregazione potrebbero produrre totali leggermente diversi. Per il confronto più accurato, assicurati di utilizzare esattamente lo stesso intervallo di date e proprietà.
Sì, GSC_TOP_QUERIES funziona con fogli automatizzati e aggiornamenti programmati. Tuttavia, presta attenzione ai limiti di quota API se hai molte formule che si aggiornano contemporaneamente. Per dashboard con più funzioni GSC, considera l'utilizzo di trigger di aggiornamento manuale o l'alternanza dei tempi di aggiornamento.
Se non ci sono dati sulle prestazioni di ricerca per l'intervallo di date specificato (ad esempio, il sito non era ancora verificato o non aveva impressioni), la funzione restituisce un risultato vuoto con solo la riga di intestazione.
No, GSC_TOP_QUERIES restituisce solo dati di ricerca web per impostazione predefinita. Google Discover e Google News hanno tipi di dati separati nell'API di Search Console. Usa GSC_QUERY con filtri del tipo di ricerca appropriati se hai bisogno di dati Discover o News.
Funzioni Correlate
GSC_TOP_PAGES
Ottieni le pagine principali da Google Search Console ordinate per clic.
GSC_PAGE_QUERIES
Ottieni le query di ricerca che generano traffico verso una pagina specifica.
GSC_KEYWORD_POSITION
Ottieni la posizione media per una parola chiave specifica da Google Search Console.
GSC_QUERY
Query personalizzata di Google Search Console con controllo completo su dimensioni e filtri.
Inizia a usare GSC_TOP_QUERIES oggi
Installa Unlimited Sheets per ottenere GSC_TOP_QUERIES e altre 41 potenti funzioni in Google Sheets.
