L'export groupé de données de la Search ConsoleOutil gratuit Google pour surveiller et optimiser la présence d'un site dans les résultats de recherche. dépose chaque jour vos données de performance dans BigQuery, sans le plafond de 1 000 lignes de l'interface ni celui de 50 000 lignes par jour de l'API. Il se règle en deux temps : un projet Google Cloud qui autorise le compte de service de la Search Console, puis l'ID de ce projet dans les paramètres de votre propriété.
Ce tutoriel suit la documentation de Google pour la mise en place, puis donne le schéma des deux tables utiles et des requêtesTerme ou expression que les utilisateurs saisissent dans un moteur de recherche. Base de toute stratégie SEO. SQL écrites pour ce schéma. Une chose à savoir avant de commencer : l'export part du jour où vous l'activez et ne remonte pas l'historique.
Interface, API ou BigQuery : quand l'export groupé devient utile
L'export groupé sert les sites dont les données dépassent ce que l'interface et l'API laissent sortir, et ceux qui veulent garder leur historique plus longtemps que la Search Console. Google le dit lui-même à l'annonce de février 2023 : les petits et moyens sites ont déjà accès à toutes leurs données par l'interface, le connecteur Looker Studio (anciennement Data Studio) ou l'API Search Analytics.
Les trois voies n'ont pas le même plafond. L'export depuis un rapport est tronqué à 1 000 lignes « d'exemples représentatifs », même si les totaux affichés comptent tout.
Pour récupérer vos données SEO via l'API, la limite passe à 50 000 lignes par jour, par site et par type de recherche, à raison de 25 000 lignes par appel avec pagination. L'export en masse vers BigQuery va plus loin : il envoie toutes les données de performance de la propriété. Seul le texte des requêtes anonymisées manque : Google les exclut à ce titre, mais leurs clics et impressions restent dans les tables.
| Interface | API Search Console | Export groupé BigQuery | |
|---|---|---|---|
| Volume | 1 000 lignes par export | 50 000 lignes par jour, par site et par type de recherche | Toutes les lignes, texte des requêtes anonymisées masqué |
| Historique | 16 derniers mois | 16 derniers mois | Depuis l'activation, conservé sans limite par défaut |
| Mise en place | Aucune | Un script qui appelle l'API | Un projet Google Cloud avec facturation |

La durée compte autant que le volume. La Search Console garde 16 mois de données ; les tables BigQuery, elles, sont conservées indéfiniment par défaut. Si vous comparez des saisons sur plusieurs années ou si vous suivez une migration sur la durée, c'est cette conservation qui justifie l'export, plus encore que le volume de lignes.
Configurer l'export groupé, étape par étape
Le réglage tient en une dizaine de clics répartis entre la console Google Cloud et la Search Console, puis vous attendez jusqu'à 48 heures la première table. Deux prérequis : un projet Google Cloud avec la facturation activée, et les droits de propriétaire sur la propriété Search Console, car seuls les propriétaires peuvent configurer l'export.

La facturation compte même si vous restez dans le niveau gratuit : sans configuration de facturation valide, l'écriture des données échoue, même avec les bons droits.
Dans la console Google Cloud
- Ouvrez la console Google Cloud et basculez sur le projet qui recevra les données.
- Dans la barre latérale, allez dans API et services > API et services activés. Si BigQuery n'y figure pas, cliquez sur + Activer les API et services et activez API BigQuery et API BigQuery Storage.
- Allez dans IAM et administration > IAM, puis cliquez sur + Accorder l'accès.
- Dans Nouveaux comptes principaux, collez le compte de service de la Search Console :
search-console-data-export@system.gserviceaccount.com. - Attribuez-lui deux rôles, Utilisateur de tâche BigQuery (
bigquery.jobUser) et Éditeur de données BigQuery (bigquery.dataEditor), puis enregistrez.
Notez au passage l'ID du projet, visible dans les paramètres du projet. C'est lui que demande la Search Console, et le numéro du projet n'y fonctionne pas.
Dans la Search Console
- Ouvrez Paramètres > Exportation groupée de données pour la propriété à exporter.
- Collez l'ID du projet dans le champ ID du projet Cloud.
- Choisissez le nom de l'ensemble de données. Par défaut, c'est
searchconsole, et un nom personnalisé commence toujours parsearchconsole. Pour exporter plusieurs propriétés dans le même projet, donnez un nom différent à chacune. - Choisissez l'emplacement de l'ensemble de données. Il se change difficilement une fois les exportations lancées : décidez-le maintenant.
- Cliquez sur Continuer. La Search Console simule un export et vous alerte tout de suite en cas de problème d'accès.
La première exportation arrive dans les 48 heures suivant la configuration et contient les données du jour de l'export. Pour les mois prAlgorithme historique de Google évaluant l'importance d'une page selon ses backlinks. Toujours utilisé en interne.écédents, il reste l'API ou les rapports : si l'historique compte pour vous, extrayez vos 16 mois par l'API le jour où vous activez l'export.
Vérifier que les données arrivent
Dans BigQuery, l'ensemble de données searchconsole apparaît avec trois tables : searchdata_site_impression, searchdata_url_impression et ExportLog. Cette dernière garde une trace de chaque export réussi, en général deux lignes par jour, une par table. Les échecs n'y figurent pas : la Search Console envoie un e-mail aux propriétaires et aux utilisateurs avec accès complet à chaque erreur, et la page de réglage de l'export affiche le statut de la dernière tentative, avec un bouton pour tester la configuration après une correction.
Ce que contiennent les tables searchdata_site_impression et searchdata_url_impression
Les deux tables portent les mêmes métriques avec deux logiques d'agrégation, celles du rapport Performances : searchdata_site_impression agrège par propriété, searchdata_url_impression agrège par URLUniform Resource Locator. Adresse unique d'une page web. Une URL optimisée est courte, descriptive et contient le mot-clé.. Dans l'interface, un tableau groupé par requête, pays ou appareil est agrégé par propriété ; un tableau groupé par page ou par apparence dans les résultats l'est par page. Les métriques y sont rattachées à l'URL canoniqueBalise indiquant la version principale d'une page en cas de contenu dupliqué ou similaire. : un paramètre de suivi comme srsltid, ajouté par Merchant Center, ne crée en principe pas de ligne à part.

Les colonnes communes sont data_date (le jour, en heure du Pacifique), site_url, query, is_anonymized_query, country (code pays ISO à trois lettres), search_type, device, impressionsNombre de fois qu'une page apparaît dans les résultats de recherche, qu'elle soit cliquée ou non. et clicks. La table par URL ajoute url, l'URL sur laquelle arrive l'internaute, des booléens is_ pour chaque apparence (résultats enrichis, AMPAccelerated Mobile Pages. Framework Google pour créer des pages mobiles ultra-rapides (moins utilisé aujourd'hui)., offres d'emploi) et is_anonymized_discover. Le champ search_type distingue la recherche web, les onglets Images, Vidéos et Actualités, Discover et Google Actualités : c'est par lui que vous isolez le trafic de Google Discover.
Trois pièges faussent les requêtes écrites trop vite.
Les lignes ne sont pas consolidées. La Search Console accumule les données par étapes, et une même requête peut occuper plusieurs lignes pour un même jour et un même type de recherche. Toute requête doit agréger avec SUM, sinon elle renvoie des lignes partielles au lieu du total.
Il n'y a ni colonne ctrClick Through Rate. Pourcentage d'utilisateurs qui cliquent sur un lien par rapport au nombre total d'impressions. ni colonne position. Le CTR se calcule avec SUM(clicks) / SUM(impressions). La position est stockée en somme, comptée à partir de zéro : la position moyenne vaut SUM(sum_top_position) / SUM(impressions) + 1 dans la table par propriété, et SUM(sum_position) / SUM(impressions) + 1 dans la table par URL. Une moyenne de CTR ou de positions ligne à ligne donne le même poids à une ligne de quelques impressions qu'à une ligne qui en compte des milliers : elle fausse le résultat. Ce que mesure vraiment cette moyenne, et comment la faire monter, est détaillé dans notre guide du positionnement sur les moteurs de recherche.
Les requêtes anonymisées sont dans les totaux. Ce sont les requêtes trop rares pour être affichées, que Google masque pour protéger la vie privée des internautes. Elles arrivent avec is_anonymized_query à vrai et forment souvent la « requête » la plus fréquente d'un site. Pour le champ query, la documentation se contredit : chaîne vide dans un paragraphe, NULL dans le suivant. Filtrez donc sur le booléen, NOT is_anonymized_query, qui couvre les deux cas, et vérifiez ce que contient votre export :
SELECT
COUNTIF(query IS NULL) AS query_null,
COUNTIF(query = '') AS query_vide
FROM `mon-projet.searchconsole.searchdata_site_impression`
WHERE data_date >= DATE_SUB(CURRENT_DATE(), INTERVAL 7 DAY)
AND is_anonymized_query;
Gardez ces lignes pour les totaux, retirez-les dès que vous classez des requêtes.
Six requêtes SQL pour vos premières analyses SEO
Les requêtes ci-dessous sont écrites pour le schéma de l'export groupé. Remplacez mon-projet par l'ID de votre projet et searchconsole par le nom de votre ensemble de données s'il est différent. Toutes filtrent sur search_type = 'WEB', la recherche web, comme les exemples de Google, et sur une fenêtre de dates pour limiter le volume lu, donc la facture.

Un point reste ambigu dans la documentation : la table de référence écrit les valeurs de search_type en minuscules (web, discover), alors que tous les exemples SQL de Google filtrent sur 'WEB'. Une comparaison de chaînes tient compte de la casse dans BigQuery, et un filtre mal écrit renvoie zéro ligne sans erreur. Lancez donc cette requête avant les autres :
SELECT DISTINCT search_type
FROM `mon-projet.searchconsole.searchdata_site_impression`
WHERE data_date >= DATE_SUB(CURRENT_DATE(), INTERVAL 7 DAY);
Si la sortie est en minuscules, remplacez 'WEB' par 'web' dans les requêtes qui suivent. Elle sert aussi pour la recherche multimodale (recherches par image avec Lens ou Entourer pour chercher), que le rapport Performances filtre à part depuis le 24 septembre 2026 : la documentation de l'export n'en parle pas, et la liste des valeurs vous dit si une valeur dédiée apparaît dans vos tables.
Vérifier que BigQuery colle à l'interface
Commencez par les totaux quotidiens des 28 derniers jours. Ils doivent retrouver la courbe du rapport Performances sur les mêmes dates, filtrée sur le type de recherche « Web : De type textuel » : c'est le contrôle qui valide tout le reste.
SELECT
data_date,
SUM(clicks) AS clics,
SUM(impressions) AS nb_impressions,
SAFE_DIVIDE(SUM(clicks), SUM(impressions)) AS ctr,
SAFE_DIVIDE(SUM(sum_top_position), SUM(impressions)) + 1 AS position_moyenne
FROM `mon-projet.searchconsole.searchdata_site_impression`
WHERE data_date BETWEEN DATE_SUB(CURRENT_DATE(), INTERVAL 28 DAY) AND CURRENT_DATE()
AND search_type = 'WEB'
GROUP BY data_date
ORDER BY data_date DESC;
Un petit écart sur les derniers jours est normal : les données les plus récentes du rapport peuvent être provisoires. Si vos tables n'ont pas de valeur multimodale dédiée et que l'écart dure au-delà des derniers jours, refaites la comparaison avec la somme des filtresSystème de filtres (taille, couleur, prix) générant de nombreuses URLs. Nécessite une gestion SEO. « Web : De type textuel » et « Web : multimodal » : celle qui colle vous dit si l'export range la recherche multimodale dans 'WEB'.
Les pages qui portent le trafic
La table par URL donne le classementPosition d'une page web dans les résultats de recherche pour une requête donnée. des pages, avec leur position moyenne pondérée par les impressions.
SELECT
url,
SUM(clicks) AS clics,
SUM(impressions) AS nb_impressions,
SAFE_DIVIDE(SUM(sum_position), SUM(impressions)) + 1 AS position_moyenne
FROM `mon-projet.searchconsole.searchdata_url_impression`
WHERE data_date BETWEEN DATE_SUB(CURRENT_DATE(), INTERVAL 28 DAY) AND CURRENT_DATE()
AND search_type = 'WEB'
GROUP BY url
ORDER BY clics DESC
LIMIT 100;
Les requêtes en positions 5 à 20
C'est la liste qui rapporte le plus vite : des couples page et requête que Google associe déjà, avec assez d'impressions pour qu'un gain de quelques places se voie. Le seuil d'impressions de la requête est un point de départ, à monter sur un gros site.
SELECT
url,
query,
SUM(impressions) AS nb_impressions,
SUM(clicks) AS clics,
SAFE_DIVIDE(SUM(sum_position), SUM(impressions)) + 1 AS position_moyenne
FROM `mon-projet.searchconsole.searchdata_url_impression`
WHERE data_date BETWEEN DATE_SUB(CURRENT_DATE(), INTERVAL 90 DAY) AND CURRENT_DATE()
AND search_type = 'WEB'
AND NOT is_anonymized_query
GROUP BY url, query
HAVING position_moyenne BETWEEN 5 AND 20
AND nb_impressions >= 100
ORDER BY nb_impressions DESC
LIMIT 200;
Ne jugez pas ces lignes au seul CTR. Un CTR bas en première page peut venir d'un Aperçu IA ou d'un bloc qui répond avant le premier lien, l'une des causes de l'effet crocodile en SEO. Comparez plutôt une page à vos autres pages placées au même rang, puis croisez la liste avec le reste de votre outillage SEO avant de retoucher un title. Dans un accompagnement, cette liste nourrit le backlog du premier mois : chaque ligne y devient une action avec un responsable et une date, la méthode que détaille l'article sur l'accompagnement SEO jugé aux recommandations mises en production.
La longue traîne et les questions
Les requêtes de cinq mots et plus pèsent peu une à une et se perdent vite dans un export limité à 1 000 lignes. Celle-ci les classe par impressions :
SELECT
query,
SUM(impressions) AS nb_impressions,
SUM(clicks) AS clics
FROM `mon-projet.searchconsole.searchdata_site_impression`
WHERE data_date BETWEEN DATE_SUB(CURRENT_DATE(), INTERVAL 90 DAY) AND CURRENT_DATE()
AND search_type = 'WEB'
AND NOT is_anonymized_query
AND ARRAY_LENGTH(SPLIT(query, ' ')) >= 5
GROUP BY query
ORDER BY nb_impressions DESC
LIMIT 200;
Pour ne garder que les questions, remplacez la condition sur le nombre de mots par AND REGEXP_CONTAINS(query, r'^(comment|pourquoi|quels?|quelles?|combien)\s'). Ces formulations nourrissent un travail de SEO vocal, une FAQ ou votre recherche de mots-clés, et la méthode pour les exploiter est dans notre guide de la longue traîne en SEO.
Les requêtes partagées entre plusieurs pages
Une requête qui fait apparaître plusieurs URL du site mérite un coup d'œil. Ce n'est pas toujours un problème : deux pages peuvent sortir ensemble, ou se relayer d'un jour à l'autre. La requête donne la liste à vérifier, le verdict se prend sur la SERPSearch Engine Results Page. Page affichée par un moteur de recherche en réponse à une requête utilisateur..
SELECT
query,
COUNT(DISTINCT url) AS nb_urls,
SUM(impressions) AS nb_impressions,
SUM(clicks) AS clics
FROM `mon-projet.searchconsole.searchdata_url_impression`
WHERE data_date BETWEEN DATE_SUB(CURRENT_DATE(), INTERVAL 28 DAY) AND CURRENT_DATE()
AND search_type = 'WEB'
AND NOT is_anonymized_query
GROUP BY query
HAVING nb_urls >= 2
AND nb_impressions >= 50
ORDER BY nb_impressions DESC
LIMIT 100;
Pour trancher entre fusion, redirection et différenciation des pages, suivez la méthode de notre article sur la cannibalisation SEO.
Une table résumé pour vos tableaux de bord
Google déconseille de brancher un tableau de bord directement sur les tables brutes : chaque affichage relance un calcul sur un gros volume, et un rapport partagé à toute l'entreprise fait vite grimper la facture. Pré-agrégez dans une table plus petite, puis branchez Looker Studio dessus.
Créez d'abord l'ensemble de données seoSearch Engine Optimization. Ensemble des techniques visant à améliorer le positionnement d'un site web dans les résultats naturels des moteurs de recherche., dans le même emplacement que searchconsole : BigQuery refuse d'écrire le résultat d'une requête dans un ensemble situé ailleurs que les tables lues. Lancez ensuite cette requête une seule fois, pour l'historique :
CREATE OR REPLACE TABLE `mon-projet.seo.pages_par_jour`
PARTITION BY data_date AS
SELECT
data_date,
url,
SUM(impressions) AS nb_impressions,
SUM(clicks) AS clics,
SUM(sum_position) AS sum_position
FROM `mon-projet.searchconsole.searchdata_url_impression`
WHERE data_date >= DATE_SUB(CURRENT_DATE(), INTERVAL 16 MONTH)
AND search_type = 'WEB'
GROUP BY data_date, url;
Planifiez ensuite chaque jour la version incrémentale, qui ne relit que les dix derniers jours : la Search Console réessaie un jour manqué pendant environ une semaine, et cette marge rattrape les jours arrivés en retard, data_date étant en heure du Pacifique. Une requête planifiée accepte ces instructions de modification (DML). La transaction garde les dix jours en place si l'insertion échoue.
BEGIN TRANSACTION;
DELETE FROM `mon-projet.seo.pages_par_jour`
WHERE data_date >= DATE_SUB(CURRENT_DATE(), INTERVAL 10 DAY);
INSERT INTO `mon-projet.seo.pages_par_jour` (data_date, url, nb_impressions, clics, sum_position)
SELECT
data_date,
url,
SUM(impressions),
SUM(clicks),
SUM(sum_position)
FROM `mon-projet.searchconsole.searchdata_url_impression`
WHERE data_date >= DATE_SUB(CURRENT_DATE(), INTERVAL 10 DAY)
AND search_type = 'WEB'
GROUP BY data_date, url;
COMMIT TRANSACTION;
La colonne sum_position reste une somme : dans le tableau de bord, la position moyenne se recalcule avec SUM(sum_position) / SUM(nb_impressions) + 1. La même table sert de base pour mesurer l'effet d'une modification, page témoin contre page modifiée, comme dans un A/B testing SEO.
Garder la facture BigQuery sous contrôle
La Search Console ne facture pas l'export. Vous payez le stockage et les requêtes BigQuery au-delà du niveau gratuit, soit 10 Gio de stockage et 1 Tio de données traitées par mois. Au-delà, c'est la façon d'écrire les requêtes qui fait la facture.

BigQuery facture au volume des colonnes lues, même avec un LIMIT. Trois réflexes réduisent ce volume :
- Filtrer sur
data_date. Les tables sont partitionnées par date : une clauseWHEREsur la période ne lit que les jours utiles. - Lister les colonnes. Un
SELECT *lit toutes les colonnes de la table, c'est la requête la plus chère qu'on puisse écrire. - Tester sur un échantillon.
TABLESAMPLElit une fraction de la table, donc coûte moins cher pendant que vous mettez une requête au point. Les fonctions approchées commeAPPROX_TOP_SUMallègent le calcul ; en tarification à la demande, elles lisent autant d'octets que la requête exacte.
Côté garde-fous, créez une alerte de budget dans Google Cloud et fixez un plafond d'octets facturés par requête : une requête qui dépasserait le plafond échoue sans être facturée.
Les données s'accumulent sans fin par défaut. Pour purger, posez une expiration sur les partitions, après un an ou 16 mois par exemple, et jamais sur la table : une expiration de table supprime toutes vos données à la date choisie. Google demande une expiration d'au moins 14 jours, et interdit de modifier le schéma des tables, ajout de colonne compris : l'export échouerait.
Quand l'export échoue : les erreurs à connaître
La plupart des échecs viennent du projet Cloud : facturation absente, API BigQuery non activée, droits manquants, emplacement ou schéma modifiés. La page de réglage de l'export affiche l'erreur de la dernière tentative ; l'explorateur de journaux de Google Cloud (LogsFichiers enregistrant toutes les requêtes reçues par un serveur, permettant d'analyser le comportement des bots. Explorer) en garde le détail : cherchez search-console-data-export.

| Message | Cause | Correction |
|---|---|---|
| Missing billing information | Pas de facturation valide sur le projet | Rattacher un compte de facturation |
| Missing BigQuery API | API BigQuery non activée | Activer API BigQuery et API BigQuery Storage |
| Missing permissions | Compte de service absent ou rôles incomplets | Reprendre les étapes IAM |
| Another bulk data export already exists | Deux propriétés visent le même ensemble de données | Un ensemble de données, ou un projet, par propriété |
| Dataset location mismatch | Un ensemble du même nom existe dans un autre emplacement | Aligner l'emplacement ou changer de nom |
| SchemaVocabulaire standardisé de balisage structuré reconnu par Google, Bing et Yahoo. mismatch | Colonne ajoutée à une table | Supprimer la colonne ajoutée ; à défaut, supprimer la table et perdre l'historique qu'elle contient |
| Partition expiration too short | Expiration de partition trop courte | Passer à 14 jours ou plus |
Ne laissez pas traîner une erreur. La Search Console réessaie d'exporter un jour manqué pendant environ une semaine, puis abandonne ce jour-là. Après environ un mois d'échecs, elle arrête l'export entièrement. Si vous préférez confier la mise en place et l'exploitation de ces données, une agence SEO technique peut s'en charger.
Questions fréquentes
L'export BigQuery récupère-t-il l'historique de la Search Console ?
Non. La première exportation contient les données du jour de l'export, et rien d'antérieur à la configuration. Pour les 16 mois que garde la Search Console, passez par l'API ou les rapports, idéalement le jour de l'activation.
Combien coûte l'export Search Console vers BigQuery ?
L'export lui-même est gratuit côté Search Console. BigQuery facture le stockage au-delà de 10 Gio par mois et les requêtes au-delà de 1 Tio de données traitées par mois. Le projet doit quand même avoir une facturation active pour que l'export fonctionne.
Pourquoi les chiffres de BigQuery diffèrent-ils de l'interface ?
Vérifiez d'abord le filtre de l'interface, « Web : De type textuel » ou la somme avec « Web : multimodal », puis la table : la table par propriété correspond aux vues par requête, pays ou appareil, la table par URL aux vues par page. Ensuite, les requêtes anonymisées restent dans les totaux de l'interface mais disparaissent si votre requête les filtre, et les jours les plus récents peuvent encore bouger.
Peut-on exporter plusieurs propriétés dans le même projet BigQuery ?
Oui, à condition de donner à chaque propriété son propre ensemble de données, dont le nom commence toujours par searchconsole. Deux propriétés ne peuvent pas écrire dans le même ensemble de données.
Sources
- Export data directly from a Search Console report, Aide Search Console, Aide Google
- A deep dive into Search Console performance data filtering and limits, Google Search Central (19 octobre 2022)
- About bulk data export of Search Console data to BigQuery, Aide Search Console, Aide Google
- Bulk data export: a new and powerful way to access your Search Console data, Google Search Central (21 février 2023)
- [GA4] Queries report, Aide Google Analytics
- Table guidelines and reference, Aide Search Console, Aide Google
- Start a new bulk data export, Aide Search Console, Aide Google
- Manage and monitor bulk data exports in Search Console, Aide Search Console, Aide Google
- Performance report (Search results), Aide Search Console, Aide Google
- Query guidelines and sample queries, Aide Search Console, Aide Google
- Query syntax, BigQuery documentation, cloud.google.com
- BigQuery efficiency tips for Search Console bulk data exports, Google Search Central (5 juin 2023)
- BigQuery pricing, Google Cloud, cloud.google.com
- Writing query results, BigQuery documentation, cloud.google.com
- Scheduling queries, BigQuery documentation, cloud.google.com
- Working with collation, BigQuery documentation, cloud.google.com
- Announcing web multimodal Search performance reporting in Search Console, Google Search Central (24 septembre 2026)
- Rapport sur les performances (résultats de recherche), Aide Search Console, Aide Google
- Multi-statement transactions, BigQuery documentation, cloud.google.com

