GSC_TOP_QUERIES
Holen Sie sich die Top-Suchanfragen aus Google Search Console sortiert nach Klicks.
=GSC_TOP_QUERIES(startDate, endDate, [limit], [siteUrl])Gibt zurück: 2D array with columns: Query, Clicks, Impressions, CTR, Position
Übersicht
GSC_TOP_QUERIES holt Ihre bestperformenden Suchanfragen direkt aus der Google Search Console API in Google Sheets. Die Funktion gibt eine umfassende Tabelle mit Metriken zurück, einschließlich des Anfragetexts, Klicks, Impressionen, Click-Through-Rate (CTR) und durchschnittlicher Position für jedes Keyword, für das Ihre Website rankt. Die Ergebnisse sind nach Klicks in absteigender Reihenfolge sortiert, sodass Sie leicht identifizieren können, welche Suchbegriffe den meisten Traffic auf Ihre Website lenken.
Parameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
startDate | string | Ja | Startdatum im Format "YYYY-MM-DD" oder relativen Format wie "-30d" für vor 30 Tagen. |
endDate | string | Ja | Enddatum im Format "YYYY-MM-DD" oder relativen Format wie "-1d" für gestern. |
limit | number | Nein (100) | Maximale Anzahl zurückzugebender Zeilen. Standard 100, maximal 25000. |
siteUrl | string | Nein | Die Website-URL-Property aus Search Console. Wenn weggelassen, wird die Standard-verbundene Property verwendet. |
Beispiele
Top-Anfragen der letzten 30 Tage
Die Top 100 Suchanfragen der letzten 30 Tage mit relativem Datumsformat abrufen.
=GSC_TOP_QUERIES("-30d", "-1d")Ausgabe
| 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 |
Top 10 Anfragen für einen bestimmten Monat
Nur die Top 10 Anfragen für Januar 2025 abrufen.
=GSC_TOP_QUERIES("2025-01-01", "2025-01-31", 10)Ausgabe
| 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 |
Vollständiger Export für eine bestimmte Property
Bis zu 25.000 Anfragen der letzten 90 Tage für eine bestimmte Search Console Domain-Property exportieren.
=GSC_TOP_QUERIES("-90d", "-1d", 25000, "sc-domain:example.com")Ausgabe
| 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 |
Schnellübersicht der letzten 7 Tage
Eine schnelle Momentaufnahme der Top 20 Anfragen der vergangenen Woche für eine wöchentliche Überprüfung abrufen.
=GSC_TOP_QUERIES("-7d", "-1d", 20)Ausgabe
| 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 |
Anwendungsfälle
Wöchentlicher SEO-Performance-Report
Marketing-Agenturen rufen wöchentlich Top-Anfragen ab, um die Keyword-Performance von Kunden zu verfolgen, Ranking-Verbesserungen zu identifizieren und über organischen Such-ROI in automatisierten Dashboards zu berichten.
Content-Gap-Analyse
Redaktionsteams analysieren Top-Anfragen, um herauszufinden, welche Themen den meisten Such-Traffic generieren und Keywords mit hohen Impressionen aber niedriger CTR zu identifizieren, die besseren Content oder Meta-Beschreibungen benötigen.
E-Commerce-Produktfindung
Online-Händler überwachen Top-Suchanfragen, um zu verstehen, wie Kunden ihre Produkte finden, Trending-Produktsuchen zu identifizieren und Produktseitentitel und -beschreibungen zu optimieren.
Konkurrenz-Keyword-Benchmarking
SaaS-Unternehmen exportieren monatlich Top-Anfragen, um sie mit Konkurrenz-Keyword-Listen zu vergleichen, Marktpositionierungschancen zu identifizieren und Paid-Search-Strategie zu informieren.
Saisonale Trenderkennung
Reiseunternehmen vergleichen Top-Anfragen über verschiedene Zeiträume hinweg, um saisonale Suchtrends zu identifizieren und Content-Kalender rund um Spitzenbuchungsperioden zu planen.
Profi-Tipps
Verwenden Sie relative Daten wie "-30d" und "-1d", um Dashboards zu erstellen, die immer die neuesten Daten anzeigen, ohne Datumszellen manuell aktualisieren zu müssen.
Kombinieren Sie mit VLOOKUP oder INDEX/MATCH gegen einen Export der vorherigen Periode, um Wochen- oder Monatsvergleiche in Klicks und Position zu berechnen.
Filtern Sie die Ergebnisse nach Anfragen, bei denen Impressionen hoch sind, aber CTR unter 3% liegt, um Ihre besten Chancen zur Verbesserung von Title-Tags und Meta-Beschreibungen zu finden.
Exportieren Sie vierteljährlich 25.000 Zeilen und verwenden Sie Pivot-Tabellen, um Long-Tail-Keyword-Trends zu verfolgen, die möglicherweise nicht in einer kürzeren Top-100-Ansicht erscheinen.
Wenn Sie mehrere Websites verwalten, verwenden Sie den siteUrl-Parameter, um Daten für jede Property in separate Tabs derselben Tabelle zu holen, um einen einfachen Vergleich zu ermöglichen.
Diese Funktion ist unverzichtbar für SEO-Profis, die regelmäßig die Keyword-Performance überwachen müssen, ohne sich manuell in Google Search Console einzuloggen. Sie können benutzerdefinierte Datumsbereiche mit standardmäßigen Datumsformaten oder praktischen relativen Daten wie "-30d" für die letzten 30 Tage oder "-7d" für die vergangene Woche angeben. Der optional Limit-Parameter ermöglicht es Ihnen, zu steuern, wie viele Zeilen zurückgegeben werden, von einer fokussierten Top-10-Liste bis zu einem umfassenden Export von bis zu 25.000 Anfragen.
Durch die Kombination von GSC_TOP_QUERIES mit anderen Tabellenfunktionen können Sie leistungsstarke SEO-Dashboards erstellen, die automatisch mit den neuesten Daten aktualisiert werden. Verfolgen Sie Wochen- oder Monatsvergleiche in Keyword-Rankings, identifizieren Sie Trending-Anfragen und erkennen Sie Chancen, bei denen Sie hohe Impressionen, aber niedrige CTR haben. Die zurückgegebenen Daten entsprechen genau dem, was Sie im Search Console Performance-Bericht sehen würden, aber mit der zusätzlichen Flexibilität, in einer Tabelle zu sein, wo Sie die Daten nach Bedarf sortieren, filtern, pivotieren und grafisch darstellen können.
Häufige Fehler
NOT_AUTHORIZED: Access to Search Console property deniedUrsache: Das mit Unlimited Sheets verbundene Google-Konto hat keinen Zugriff auf die angegebene Search Console Property.
Lösung: Stellen Sie sicher, dass Ihr Google-Konto mindestens "Vollständige" Berechtigung für die Search Console Property hat. Gehen Sie zu Search Console > Einstellungen > Nutzer und Berechtigungen, um den Zugriff zu überprüfen. Wenn Sie eine Domain-Property verwenden, stellen Sie sicher, dass Sie die Eigentümerschaft verifiziert haben.
INVALID_DATE: Start date must be before end dateUrsache: Das Startdatum liegt nach dem Enddatum oder eines der Daten hat ein ungültiges Format.
Lösung: Überprüfen Sie, dass Ihre Daten im Format "YYYY-MM-DD" vorliegen und dass das Startdatum chronologisch vor dem Enddatum liegt. Bei relativen Daten denken Sie daran, dass "-30d" vor 30 Tagen (früher) und "-1d" gestern (später) bedeutet.
PROPERTY_NOT_FOUND: No Search Console property connectedUrsache: Es wurde keine Standard-Search Console Property festgelegt und keine siteUrl angegeben.
Lösung: Geben Sie entweder den siteUrl-Parameter explizit an (z.B. "sc-domain:example.com") oder verbinden Sie eine Standard-Property über die Unlimited Sheets Search Console Seitenleiste (Erweiterungen > Unlimited Sheets > Search Console).
Häufig Gestellte Fragen
Google Search Console speichert Daten der letzten 16 Monate. Sie können jeden Datumsbereich innerhalb dieses Zeitfensters verwenden. Daten können im Format "YYYY-MM-DD" oder als relative Daten wie "-30d" (vor 30 Tagen), "-7d" (vor 7 Tagen) oder "-1d" (gestern) angegeben werden. Die aktuellsten verfügbaren Daten stammen typischerweise von vor 2-3 Tagen aufgrund von Googles Verarbeitungsverzögerung.
Sie können bis zu 25.000 Anfragen pro Anforderung abrufen, indem Sie den Limit-Parameter setzen. Der Standard ist 100, wenn kein Limit angegeben ist. Für Websites mit mehr als 25.000 rankenden Anfragen erwägen Sie, GSC_QUERY mit Datumsdimension zu verwenden, um Daten über mehrere Datumsbereiche hinweg aufzuteilen.
Ergebnisse werden immer nach Klicks in absteigender Reihenfolge sortiert und zeigen Ihre Traffic-stärksten Anfragen zuerst. Wenn Sie eine andere Sortierreihenfolge benötigen, können Sie Google Sheets SORT-Funktion auf die zurückgegebenen Daten verwenden, zum Beispiel =SORT(GSC_TOP_QUERIES("-30d", "-1d"), 5, TRUE) um nach Position aufsteigend zu sortieren.
Die siteUrl sollte genau mit Ihrer Search Console Property übereinstimmen. Für Domain-Properties verwenden Sie "sc-domain:example.com". Für URL-Präfix-Properties verwenden Sie die vollständige URL wie "https://www.example.com/". Wenn weggelassen, verwendet die Funktion die Standard-Property, die Sie während der Einrichtung verbunden haben.
Geringfügige Diskrepanzen sind normal und können aufgrund von Daten-Sampling, Zeitzonenunterschieden oder Rundung auftreten. Die API-Daten und die Search Console UI verwenden denselben zugrunde liegenden Datensatz, aber Aggregationsmethoden können leicht unterschiedliche Summen erzeugen. Für den genauesten Vergleich stellen Sie sicher, dass Sie exakt denselben Datumsbereich und dieselbe Property verwenden.
Ja, GSC_TOP_QUERIES funktioniert mit automatisierten Sheets und geplanten Aktualisierungen. Beachten Sie jedoch API-Quotengrenzen, wenn Sie viele Formeln gleichzeitig aktualisieren. Für Dashboards mit mehreren GSC-Funktionen erwägen Sie manuelle Aktualisierungstrigger oder gestaffelte Aktualisierungszeiten.
Wenn es keine Suchperformance-Daten für den angegebenen Datumsbereich gibt (zum Beispiel war die Website noch nicht verifiziert oder hatte keine Impressionen), gibt die Funktion ein leeres Ergebnis nur mit der Kopfzeile zurück.
Nein, GSC_TOP_QUERIES gibt standardmäßig nur Websuche-Daten zurück. Google Discover und Google News haben separate Datentypen in der Search Console API. Verwenden Sie GSC_QUERY mit entsprechenden Suchtyp-Filtern, wenn Sie Discover- oder News-Daten benötigen.
Verwandte Funktionen
GSC_TOP_PAGES
Holen Sie sich die Top-Seiten aus Google Search Console sortiert nach Klicks.
GSC_PAGE_QUERIES
Holen Sie sich Suchanfragen, die Traffic zu einer bestimmten Seite lenken.
GSC_KEYWORD_POSITION
Holen Sie sich die durchschnittliche Position für ein bestimmtes Keyword aus Google Search Console.
GSC_QUERY
Benutzerdefinierte Google Search Console Anfrage mit voller Kontrolle über Dimensionen und Filter.
Beginnen Sie noch heute mit GSC_TOP_QUERIES
Installieren Sie Unlimited Sheets, um GSC_TOP_QUERIES und 41 weitere leistungsstarke Funktionen in Google Sheets zu erhalten.
