GSC_TOP_QUERIES
Récupérez les meilleures requêtes de recherche depuis Google Search Console triées par clics.
=GSC_TOP_QUERIES(startDate, endDate, [limit], [siteUrl])Retourne : 2D array with columns: Query, Clicks, Impressions, CTR, Position
Aperçu
GSC_TOP_QUERIES extrait vos requêtes de recherche les plus performantes directement depuis l'API Google Search Console dans Google Sheets. La fonction renvoie un tableau complet de métriques incluant le texte de la requête, les clics, les impressions, le taux de clics (CTR) et la position moyenne pour chaque mot-clé sur lequel votre site se positionne. Les résultats sont triés par clics décroissants, ce qui facilite l'identification des termes de recherche qui génèrent le plus de trafic vers votre site.
Paramètres
| Paramètre | Type | Requis | Description |
|---|---|---|---|
startDate | string | Oui | Date de début au format "YYYY-MM-DD" ou format relatif comme "-30d" pour il y a 30 jours. |
endDate | string | Oui | Date de fin au format "YYYY-MM-DD" ou format relatif comme "-1d" pour hier. |
limit | number | Non (100) | Nombre maximum de lignes à renvoyer. Par défaut 100, maximum 25000. |
siteUrl | string | Non | L'URL de propriété de Search Console. Si omise, utilise la propriété connectée par défaut. |
Exemples
Top requêtes des 30 derniers jours
Récupérer les 100 meilleures requêtes de recherche des 30 derniers jours en utilisant le format de date relative.
=GSC_TOP_QUERIES("-30d", "-1d")Sortie
| 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 requêtes pour un mois spécifique
Obtenir seulement les 10 meilleures requêtes pour janvier 2025.
=GSC_TOP_QUERIES("2025-01-01", "2025-01-31", 10)Sortie
| 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 |
Exportation complète pour une propriété spécifique
Exporter jusqu'à 25 000 requêtes des 90 derniers jours pour une propriété de domaine Search Console spécifique.
=GSC_TOP_QUERIES("-90d", "-1d", 25000, "sc-domain:example.com")Sortie
| 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 |
Aperçu rapide des 7 derniers jours
Obtenir un instantané rapide des 20 meilleures requêtes de la semaine passée pour une revue hebdomadaire.
=GSC_TOP_QUERIES("-7d", "-1d", 20)Sortie
| 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 |
Cas d'Usage
Rapport hebdomadaire de performance SEO
Les agences marketing extraient les principales requêtes hebdomadairement pour suivre les performances de mots-clés des clients, identifier les améliorations de classement et rapporter le ROI de la recherche organique dans des tableaux de bord automatisés.
Analyse des lacunes de contenu
Les équipes éditoriales analysent les principales requêtes pour découvrir quels sujets génèrent le plus de trafic de recherche et identifier les mots-clés à impressions élevées et CTR faible qui nécessitent un meilleur contenu ou des meta descriptions.
Découverte de produits E-commerce
Les détaillants en ligne surveillent les principales requêtes de recherche pour comprendre comment les clients trouvent leurs produits, identifier les recherches de produits tendances et optimiser les titres et descriptions des pages produits.
Benchmarking de mots-clés concurrents
Les entreprises SaaS exportent les principales requêtes mensuellement pour comparer avec les listes de mots-clés concurrents, identifier les opportunités de positionnement sur le marché et informer la stratégie de recherche payante.
Détection des tendances saisonnières
Les entreprises de voyage comparent les principales requêtes sur différentes périodes pour identifier les tendances de recherche saisonnières et planifier les calendriers de contenu autour des périodes de réservation de pointe.
Conseils Pro
Utilisez des dates relatives comme "-30d" et "-1d" pour créer des tableaux de bord qui affichent toujours les dernières données sans avoir à mettre à jour manuellement les cellules de date.
Combinez avec VLOOKUP ou INDEX/MATCH contre une exportation de période précédente pour calculer les changements semaine après semaine ou mois après mois dans les clics et la position.
Filtrez les résultats pour les requêtes où les impressions sont élevées mais le CTR est inférieur à 3% pour trouver vos meilleures opportunités d'amélioration des balises de titre et des meta descriptions.
Exportez 25 000 lignes trimestriellement et utilisez des tableaux croisés dynamiques pour suivre les tendances de mots-clés longue traîne qui peuvent ne pas apparaître dans une vue top-100 plus courte.
Si vous gérez plusieurs sites, utilisez le paramètre siteUrl pour extraire des données pour chaque propriété dans des onglets séparés de la même feuille de calcul pour une comparaison facile.
Cette fonction est essentielle pour les professionnels du SEO qui doivent surveiller régulièrement les performances des mots-clés sans se connecter manuellement à Google Search Console. Vous pouvez spécifier des plages de dates personnalisées en utilisant des formats de date standard ou des dates relatives pratiques comme "-30d" pour les 30 derniers jours ou "-7d" pour la semaine passée. Le paramètre de limite optionnel vous permet de contrôler combien de lignes sont renvoyées, d'une liste concentrée du top 10 à une exportation complète allant jusqu'à 25 000 requêtes.
En combinant GSC_TOP_QUERIES avec d'autres formules de feuille de calcul, vous pouvez créer de puissants tableaux de bord SEO qui se rafraîchissent automatiquement avec les dernières données. Suivez les changements hebdomadaires ou mensuels dans les classements de mots-clés, identifiez les requêtes tendances et repérez les opportunités où vous avez des impressions élevées mais un CTR faible. Les données renvoyées correspondent exactement à ce que vous verriez dans le rapport Performance de Search Console, mais avec la flexibilité supplémentaire d'être dans une feuille de calcul où vous pouvez trier, filtrer, pivoter et représenter graphiquement les données comme vous le souhaitez.
Erreurs Courantes
NOT_AUTHORIZED: Accès à la propriété Search Console refuséCause : Le compte Google connecté à Unlimited Sheets n'a pas accès à la propriété Search Console spécifiée.
Solution : Assurez-vous que votre compte Google dispose au moins de l'autorisation "Complète" sur la propriété Search Console. Allez dans Search Console > Paramètres > Utilisateurs et autorisations pour vérifier l'accès. Si vous utilisez une propriété de domaine, assurez-vous d'avoir vérifié la propriété.
INVALID_DATE: La date de début doit être antérieure à la date de finCause : La startDate est postérieure à la endDate, ou l'une des dates est dans un format invalide.
Solution : Vérifiez que vos dates sont au format "YYYY-MM-DD" et que la date de début vient chronologiquement avant la date de fin. Lors de l'utilisation de dates relatives, rappelez-vous que "-30d" signifie il y a 30 jours (plus tôt) et "-1d" signifie hier (plus tard).
PROPERTY_NOT_FOUND: Aucune propriété Search Console connectéeCause : Aucune propriété Search Console par défaut n'a été définie et aucun siteUrl n'a été fourni.
Solution : Soit fournissez le paramètre siteUrl explicitement (par ex., "sc-domain:example.com"), soit connectez une propriété par défaut via la barre latérale Unlimited Sheets Search Console (Extensions > Unlimited Sheets > Search Console).
Questions Fréquentes
Google Search Console conserve les données des 16 derniers mois. Vous pouvez utiliser n'importe quelle plage de dates dans cette fenêtre. Les dates peuvent être spécifiées au format "YYYY-MM-DD" ou comme dates relatives comme "-30d" (il y a 30 jours), "-7d" (il y a 7 jours) ou "-1d" (hier). Les données les plus récentes disponibles datent généralement de 2 à 3 jours en raison du délai de traitement de Google.
Vous pouvez récupérer jusqu'à 25 000 requêtes par demande en définissant le paramètre de limite. La valeur par défaut est 100 si aucune limite n'est spécifiée. Pour les sites avec plus de 25 000 requêtes de classement, envisagez d'utiliser GSC_QUERY avec dimension de date pour diviser les données sur plusieurs plages de dates.
Les résultats sont toujours triés par clics décroissants, montrant vos requêtes à plus fort trafic en premier. Si vous avez besoin d'un ordre de tri différent, vous pouvez utiliser la fonction SORT de Google Sheets sur les données renvoyées, par exemple =SORT(GSC_TOP_QUERIES("-30d", "-1d"), 5, TRUE) pour trier par position croissante.
Le siteUrl doit correspondre exactement à votre propriété Search Console. Pour les propriétés de domaine, utilisez "sc-domain:example.com". Pour les propriétés de préfixe d'URL, utilisez l'URL complète comme "https://www.example.com/". Si omis, la fonction utilise la propriété par défaut que vous avez connectée lors de la configuration.
Des écarts mineurs sont normaux et peuvent survenir en raison de l'échantillonnage des données, des différences de fuseau horaire ou de l'arrondi. Les données de l'API et l'interface utilisateur de Search Console utilisent le même ensemble de données sous-jacent, mais les méthodes d'agrégation peuvent produire des totaux légèrement différents. Pour la comparaison la plus précise, assurez-vous d'utiliser exactement la même plage de dates et propriété.
Oui, GSC_TOP_QUERIES fonctionne avec les feuilles automatisées et les rafraîchissements planifiés. Cependant, soyez attentif aux limites de quota d'API si vous avez de nombreuses formules qui se rafraîchissent simultanément. Pour les tableaux de bord avec plusieurs fonctions GSC, envisagez d'utiliser des déclencheurs de rafraîchissement manuel ou d'échelonner les temps de rafraîchissement.
S'il n'y a pas de données de performance de recherche pour la plage de dates spécifiée (par exemple, le site n'était pas encore vérifié ou n'avait pas d'impressions), la fonction renvoie un résultat vide avec seulement la ligne d'en-tête.
Non, GSC_TOP_QUERIES renvoie uniquement les données de recherche web par défaut. Google Discover et Google News ont des types de données séparés dans l'API Search Console. Utilisez GSC_QUERY avec les filtres de type de recherche appropriés si vous avez besoin de données Discover ou News.
Fonctions Associées
GSC_TOP_PAGES
Récupérez les meilleures pages depuis Google Search Console triées par clics.
GSC_PAGE_QUERIES
Récupérez les requêtes de recherche générant du trafic vers une page spécifique.
GSC_KEYWORD_POSITION
Récupérez la position moyenne pour un mot-clé spécifique depuis Google Search Console.
GSC_QUERY
Requête personnalisée Google Search Console avec contrôle total sur les dimensions et filtres.
Commencez à utiliser GSC_TOP_QUERIES aujourd'hui
Installez Unlimited Sheets pour obtenir GSC_TOP_QUERIES et 41 autres fonctions puissantes dans Google Sheets.
