GSC_QUERY
Requête personnalisée Google Search Console avec contrôle total sur les dimensions et filtres.
=GSC_QUERY(startDate, endDate, [dimensions], [limit], [filterDimension], [filterOperator], [filterValue], [siteUrl])Retourne : 2D array with columns for each selected dimension + Clicks, Impressions, CTR, Position
Aperçu
GSC_QUERY est la fonction Search Console la plus flexible et puissante, vous donnant un contrôle complet sur les données que vous récupérez et comment elles sont structurées. Alors que les autres fonctions GSC couvrent les cas d'usage courants avec des paramètres simplifiés, GSC_QUERY vous permet de spécifier des dimensions personnalisées, d'appliquer des filtres et de combiner plusieurs axes de données en une seule requête. Elle reflète les capacités complètes du point de terminaison searchAnalytics.query de l'API Google Search Console, rendant possible la création de pratiquement n'importe quel rapport de performance de recherche.
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. |
dimensions | string | Non (query) | Liste séparée par des virgules de dimensions : query, page, country, device, date. Par défaut "query". |
limit | number | Non (100) | Nombre maximum de lignes à renvoyer. Par défaut 100, maximum 25000. |
filterDimension | string | Non | La dimension sur laquelle filtrer : query, page, country ou device. |
filterOperator | string | Non | L'opérateur de filtre : "equals", "contains" ou "notContains". |
filterValue | string | Non | La valeur par laquelle filtrer (par ex., un motif d'URL, un code pays ou un mot-clé). |
siteUrl | string | Non | L'URL de propriété de Search Console. Si omise, utilise la propriété connectée par défaut. |
Exemples
Requêtes par pays
Obtenir les principales requêtes réparties par pays pour comprendre les performances de recherche géographiques.
=GSC_QUERY("-30d", "-1d", "query,country", 500)Sortie
| Query | Country | Clicks | Impressions | CTR | Position |
| best crm software | USA | 520 | 9400 | 5.5% | 3.1 |
| best crm software | GBR | 180 | 3200 | 5.6% | 3.4 |
| crm comparison | USA | 340 | 6100 | 5.6% | 4.2 |
| crm comparison | DEU | 95 | 2100 | 4.5% | 5.8 |
Tendances de clics quotidiens
Obtenir les clics et impressions quotidiens totaux pour les 14 derniers jours pour représenter graphiquement les tendances de recherche globales.
=GSC_QUERY("-14d", "-1d", "date", 14)Sortie
| Date | Clicks | Impressions | CTR | Position |
| 2025-03-01 | 1250 | 18500 | 6.8% | 12.3 |
| 2025-03-02 | 1180 | 17800 | 6.6% | 12.5 |
| 2025-03-03 | 1420 | 21200 | 6.7% | 11.8 |
Requêtes de blog uniquement filtrées par page
Obtenir les requêtes qui ont seulement généré du trafic vers les pages de blog en filtrant sur l'URL de page contenant "/blog/".
=GSC_QUERY("-30d", "-1d", "query", 200, "page", "contains", "/blog/")Sortie
| Query | Clicks | Impressions | CTR | Position |
| how to write a business plan | 890 | 14200 | 6.3% | 3.8 |
| business plan template | 720 | 12500 | 5.8% | 4.1 |
| startup business plan example | 540 | 8900 | 6.1% | 4.5 |
Analyse du trafic non-marque
Exclure les requêtes de nom de marque pour analyser uniquement les performances de recherche organique non-marque.
=GSC_QUERY("-30d", "-1d", "query", 1000, "query", "notContains", "mycompany")Sortie
| Query | Clicks | Impressions | CTR | Position |
| project management tools | 980 | 22100 | 4.4% | 5.1 |
| task tracking software | 650 | 14800 | 4.4% | 6.3 |
| team collaboration app | 520 | 11200 | 4.6% | 5.8 |
Performance mobile vs ordinateur par page
Répartir les performances de page par type d'appareil pour identifier les pages qui sous-performent sur mobile.
=GSC_QUERY("-30d", "-1d", "page,device", 500)Sortie
| Page | Device | Clicks | Impressions | CTR | Position |
| https://example.com/pricing | DESKTOP | 1800 | 24000 | 7.5% | 2.3 |
| https://example.com/pricing | MOBILE | 1200 | 19000 | 6.3% | 2.8 |
| https://example.com/blog/guide | DESKTOP | 950 | 13500 | 7.0% | 3.5 |
| https://example.com/blog/guide | MOBILE | 1100 | 16200 | 6.8% | 3.2 |
Cas d'Usage
Analyse de performance géographique
Les entreprises internationales analysent les performances de recherche par pays pour identifier quels marchés ont la visibilité organique la plus forte et où investir dans du contenu localisé et des efforts SEO.
Tableau de bord de surveillance SEO quotidienne
Les agences construisent des tableaux de bord de surveillance quotidienne en utilisant la dimension "date" pour suivre les tendances de clics, repérer les baisses soudaines de trafic et corréler les changements avec les mises à jour d'algorithme Google ou l'activité des concurrents.
Optimisation SEO mobile-first
Les équipes de développement comparent les performances mobile vs. ordinateur pour les pages clés, identifiant les problèmes de classement spécifiques au mobile qui indiquent des problèmes Core Web Vitals ou d'utilisabilité mobile.
Reporting de trafic non-marque
Les équipes marketing isolent le trafic de recherche non-marque en utilisant des filtres de requête pour mesurer la véritable croissance de recherche organique indépendante des campagnes de notoriété de marque et des recherches directes de marque.
Performance des sections de contenu
Les éditeurs filtrent par motifs d'URL de page pour comparer les performances à travers les sections de contenu (actualités, opinions, critiques, tutoriels), guidant l'allocation des ressources éditoriales.
Évaluation de l'impact des mises à jour d'algorithme
Les consultants SEO utilisent des requêtes dimension-date autour des dates de mise à jour d'algorithme connues pour mesurer l'impact sur les sites clients, fournissant des recommandations basées sur les données pour les stratégies de récupération.
Conseils Pro
Utilisez la dimension "date" sans aucune autre dimension pour obtenir les totaux de clics quotidiens à l'échelle du site, parfait pour créer un simple graphique de tendance de trafic.
Filtrez par page "contains" un segment d'URL pour analyser les performances pour des sections de site spécifiques sans avoir besoin de connaître chaque URL de page individuelle.
Combinez les dimensions "query,date" avec un filtre de requête pour suivre les changements de position quotidiens pour un mot-clé spécifique au fil du temps, créant une ligne de tendance de position.
Utilisez la dimension "query" avec un filtre de page (filterDimension "page", filterOperator "contains", filterValue "/product/") pour trouver tous les mots-clés générant du trafic spécifiquement vers les pages produits.
Pour l'analyse du trafic non-marque, utilisez filterDimension "query" avec filterOperator "notContains" et votre nom de marque comme filterValue. C'est plus efficace que de filtrer après coup.
Le paramètre dimensions contrôle quelles colonnes de données sont renvoyées. Vous pouvez demander n'importe quelle combinaison de "query", "page", "country", "device" et "date" comme chaîne séparée par des virgules. Par exemple, dimensions "query,country" renvoie les performances de recherche réparties à la fois par mot-clé et par pays, tandis que "page,device" montre les performances de page divisées par ordinateur, mobile et tablette. La dimension "date" est particulièrement puissante car elle permet l'analyse chronologique, vous permettant de représenter graphiquement les tendances quotidiennes pour les clics, impressions et positions.
Le système de filtrage permet de réduire les résultats à des sous-ensembles spécifiques de vos données. Choisissez une dimension de filtre (query, page, country ou device), un opérateur (equals, contains ou notContains) et une valeur pour inclure ou exclure des données spécifiques. Par exemple, filtrez par page "contains" "/blog/" pour voir uniquement les performances du contenu de blog, ou filtrez par query "notContains" "nom de marque" pour isoler le trafic de recherche non-marque. Cela élimine le besoin de post-traitement avec des fonctions FILTER et réduit le transfert de données.
GSC_QUERY est la fonction à utiliser lorsque les fonctions GSC plus simples ne fournissent pas exactement la vue de données dont vous avez besoin. Que vous souhaitiez des répartitions au niveau pays, des performances spécifiques à l'appareil, des données de tendances quotidiennes ou des sous-ensembles filtrés de vos analyses de recherche, cette fonction les fournit avec une seule formule.
Erreurs Courantes
INVALID_DIMENSION: Dimension inconnue spécifiéeCause : Le paramètre dimensions contient un nom de dimension non reconnu. Les dimensions valides sont : query, page, country, device, date.
Solution : Vérifiez les fautes de frappe dans le paramètre dimensions. Utilisez uniquement les valeurs prises en charge : "query", "page", "country", "device", "date". Séparez plusieurs dimensions par des virgules et sans espaces (par ex., "query,country" pas "query, country").
INVALID_FILTER: L'opérateur de filtre doit être equals, contains ou notContainsCause : Le paramètre filterOperator contient une valeur d'opérateur non prise en charge.
Solution : Utilisez l'un des trois opérateurs pris en charge : "equals" pour correspondance exacte, "contains" pour correspondance partielle ou "notContains" pour exclusion. Ces opérateurs sont sensibles à la casse dans le paramètre mais appliquent une correspondance insensible à la casse aux données.
INCOMPLETE_FILTER: Les trois paramètres de filtre doivent être fournis ensembleCause : Seuls certains des paramètres de filtre (filterDimension, filterOperator, filterValue) ont été fournis. Les trois sont requis lors de l'utilisation de filtres.
Solution : Lors de l'application d'un filtre, vous devez fournir les trois paramètres : filterDimension (sur quoi filtrer), filterOperator (comment filtrer) et filterValue (quelle valeur correspondre). Si vous ne voulez pas filtrer, omettez les trois paramètres.
Questions Fréquentes
Vous pouvez combiner n'importe laquelle de ces dimensions : "query", "page", "country", "device" et "date". Passez-les comme chaîne séparée par des virgules comme "query,country" ou "page,device,date". Chaque combinaison vous donne une coupe transversale de données différente. Notez que plus de dimensions résultent en données plus granulaires et plus de lignes, donc vous devrez peut-être augmenter le paramètre de limite.
Les valeurs de pays sont renvoyées sous forme de codes ISO 3166-1 alpha-3 à 3 lettres (par ex., "USA", "GBR", "DEU", "FRA", "JPN"). Lors du filtrage par pays, utilisez ces mêmes codes. Par exemple, filterDimension "country", filterOperator "equals", filterValue "USA" pour obtenir uniquement les données de recherche américaines.
La dimension device renvoie trois valeurs : "DESKTOP", "MOBILE" et "TABLET". Lors du filtrage par appareil, utilisez ces chaînes exactes. Par exemple, filterDimension "device", filterOperator "equals", filterValue "MOBILE" pour obtenir uniquement les données de recherche mobile.
La fonction actuelle prend en charge un seul filtre par appel. Pour plusieurs conditions de filtre, vous pouvez soit faire des appels GSC_QUERY séparés avec différents filtres, soit appliquer un seul filtre d'API puis utiliser la fonction FILTER de Google Sheets sur les résultats pour un filtrage supplémentaire. Pour la plupart des cas d'usage, un filtre combiné avec des formules de feuille de calcul est suffisant.
L'opérateur "equals" correspond à la valeur exacte (par ex., query equals "seo tools" correspond uniquement à cette requête exacte). L'opérateur "contains" correspond si la valeur de dimension inclut la chaîne de filtre n'importe où (par ex., page contains "/blog/" correspond à toute URL avec /blog/ dedans). L'opérateur "notContains" exclut les valeurs correspondantes (par ex., query notContains "nom de marque" exclut toutes les requêtes de marque). Ces opérateurs sont insensibles à la casse.
Lorsque "date" est incluse comme dimension, les résultats sont répartis par jour individuel. Chaque ligne inclut une colonne de date au format "YYYY-MM-DD" ainsi que les métriques pour ce jour spécifique. C'est essentiel pour l'analyse chronologique et la représentation graphique des tendances. Sans la dimension date, les métriques sont agrégées sur toute la plage de dates.
Le maximum est de 25 000 lignes quelle que soit la dimension. Cependant, combiner plusieurs dimensions augmente considérablement le nombre de lignes uniques. Par exemple, 1 000 requêtes sur 5 pays produiraient jusqu'à 5 000 lignes. Si vos données dépassent la limite, réduisez votre plage de dates, ajoutez un filtre ou réduisez les dimensions.
Oui, GSC_QUERY est la fonction de puissance sous-jacente. GSC_TOP_QUERIES est équivalent à GSC_QUERY avec dimensions "query", GSC_TOP_PAGES avec dimensions "page", GSC_PAGE_QUERIES avec dimensions "query" et un filtre de page, et GSC_KEYWORD_POSITION avec dimensions "query" et un filtre de requête. Les fonctions spécialisées sont plus simples à utiliser pour les cas courants.
Fonctions Associées
GSC_TOP_QUERIES
Récupérez les meilleures requêtes de recherche depuis Google Search Console triées par clics.
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.
Commencez à utiliser GSC_QUERY aujourd'hui
Installez Unlimited Sheets pour obtenir GSC_QUERY et 41 autres fonctions puissantes dans Google Sheets.
