Search Console
Données de performance Google Search Console (impressions, clics, CTR, position moyenne) des projets dont une propriété GSC est connectée. Disponible à partir du forfait Growth. ctr est une fraction entre 0 et 1 et position la moyenne pondérée par les impressions. L’en-tête de réponse X-Search-Console-Backend indique une lecture stored ou live. Les lectures stockées utilisent les données synchronisées sans contacter Google. Les lectures en direct renvoient ERR_SEARCH_CONSOLE_ACCESS_REVOKED (403) si l’accès Google a été révoqué ; reconnectez la propriété dans Préférences > Paramètres du projet > Connexions. Elles renvoient ERR_SEARCH_CONSOLE_UPSTREAM (503) quand Google est indisponible ou que le quota Google est dépassé ; attendez le nombre de secondes indiqué dans Retry-After avant de réessayer. Les lectures stockées refusent avec ERR_INVALID_PARAM les appels portant sur les requêtes ou les pages, ainsi que les appels restreints. Pour les requêtes et les pages, total compte les lignes d’un seul appel à Google, jusqu’à 25 000 (truncated: true à cette limite). Les listes de lignes ne s’additionnent pas pour donner les totaux : pour totaliser un ensemble de pages ou de requêtes, appelez /search_console/summary avec filters et sans dimension. Un projet peut connecter jusqu’à 10 propriétés : property en lit une (la principale s’il est omis) ou en combine plusieurs avec une liste séparée par des virgules ou all.
GET/search_console/properties
Les propriétés connectées au projet, la principale en premier, avec leur type (domain ou url_prefix) et leur statut. Chaque ID est une valeur acceptée par le paramètre property des autres endpoints Search Console.
project_idobligatoireoutputflat|csv
GET/search_console/summary
Totaux principaux de la période, pour toute la propriété sauf si filters les restreint, avec une répartition facultative agrégée sur la même période. breakdown_truncated: true signifie que la répartition a omis des lignes. Les lignes de requêtes excluent les requêtes anonymisées, et les lignes de pages et de searchAppearance sont comptées par page et non par propriété : les lignes de la répartition peuvent donc différer des totaux.
project_idobligatoirepropertyun ID, une liste séparée par des virgules ouallrangefromtodimensioncountry|device|page|query|searchAppearance|propertylimit1 000 par défaut et au maximumsearch_typeweb|image|video|news|discover|googleNewsfiltersdata_statefinal|allaggregation_typeauto|byPage|byProperty
GET/search_console/timeseries
Séries agrégées par jour, semaine ou mois, pour toute la propriété sauf si filters les restreint.
project_idobligatoirepropertyun ID, une liste séparée par des virgules ouallrangefromtogranularityday|week|monthsearch_typeweb|image|video|news|discover|googleNewsfiltersdata_statefinal|allaggregation_typeauto|byPage|byPropertyoutputflat|csv
GET/search_console/queries
Principales requêtes de recherche de la période, classées et paginées. Les requêtes anonymisées sont sciemment sous-comptées : la somme des lignes ne correspond donc pas exactement aux totaux de la synthèse (comme dans l’interface Search Console).
project_idobligatoirepropertyun ID, une liste séparée par des virgules ouallrangefromtosortimpressions|clicks|ctr|positionpageper_pagestart_rowsearch_typeweb|image|video|news|discover|googleNewsfiltersdata_statefinal|allaggregation_typeauto|byPage|byPropertyoutputflat|csv
GET/search_console/pages
Principales pages de destination de la période, classées et paginées. Même structure que l’endpoint des requêtes, la clé de chaque ligne étant l’URL d’une page.
project_idobligatoirepropertyun ID, une liste séparée par des virgules ouallrangefromtosortimpressions|clicks|ctr|positionpageper_pagestart_rowsearch_typeweb|image|video|news|discover|googleNewsfiltersdata_statefinal|allaggregation_typeauto|byPage|byPropertyoutputflat|csv
GET/search_console/rows
Lignes regroupées selon trois dimensions au plus, par exemple page et requête, ou date et page, classées et paginées. Chaque dimension a son propre champ. Google renvoie au maximum 25 000 lignes par appel : truncated: true signale une fenêtre complète, et start_row permet de lire la suivante.
project_idobligatoiredimensionsobligatoire, séparées par des virgules, de 1 à 3 parmidate|country|device|page|query|searchAppearance|propertypropertyun ID, une liste séparée par des virgules ouallrangefromtosortimpressions|clicks|ctr|positionpageper_pagestart_rowsearch_typefiltersdata_statefinal|allaggregation_typeauto|byPage|byPropertyoutputflat|csv
GET/search_console/opportunities
Requêtes positionnées juste sous le top 3 et ayant suffisamment d’impressions, classées selon les clics qu’un passage dans le top 3 ajouterait, au CTR qu’obtiennent les requêtes du top 3 de la propriété sur la même période. Utilisez cet endpoint pour repérer les requêtes où un petit gain de position apporterait le plus de trafic.
project_idobligatoirepropertyun ID, une liste séparée par des virgules ouallrangefromtomin_impressions100 par défautmin_position4 par défautmax_position20 par défautpageper_pagesearch_typefiltersdata_statefinal|allaggregation_typeauto|byPage|byPropertyoutputflat|csv
GET/search_console/cannibalization
Requêtes pour lesquelles au moins deux pages obtiennent chacune au moins min_share des impressions, avec leurs pages concurrentes. Google comptabilise ces impressions par page : le chiffre d’une requête peut donc être plus élevé ici qu’à l’échelle de la propriété. Utilisez cet endpoint pour repérer les mots-clés que plusieurs pages du site se disputent, et décider quelles pages fusionner, rediriger ou différencier.
project_idobligatoirepropertyun ID, une liste séparée par des virgules ouallrangefromtomin_impressions100 par défautmin_sharede 0.01 à 0.5, 0.1 par défautpageper_pagesearch_typefiltersdata_statefinal|allaggregation_typeauto|byPage|byPropertyoutputflat|csv
GET/search_console/decay
Pages, ou requêtes, qui ont perdu le plus de clics par rapport à la période de même durée qui précède, avec les clics, les impressions et la position sur les deux périodes. La période demandée se termine au dernier jour publié par Google (compared_through) : les jours dont les données sont encore incomplètes ne comptent donc jamais comme une perte. Utilisez cet endpoint pour repérer les pages qui perdent du trafic et distinguer une perte de positionnement (position dégradée) d’une baisse de la demande (moins d’impressions à position stable).
project_idobligatoirepropertyun ID, une liste séparée par des virgules ouallrangefromtodimensionpage|querymin_clicks10 par défautpageper_pagesearch_typefiltersdata_statefinal|allaggregation_typeauto|byPage|byPropertyoutputflat|csv
GET/search_console/brand_split
Impressions et clics des requêtes qui contiennent le nom de la marque et de celles qui ne le contiennent pas, avec les totaux. Une requête de marque contient l’un des termes de marque du projet sous forme de mot entier : son nom de marque, ses variantes du nom, ses noms d’application et son domaine, chacun aussi sous sa forme sans accents. Google applique la répartition à toutes les requêtes qu’il comptabilise. Il exclut les requêtes anonymisées de tout filtre de requête : unclassified contient donc ce qu’aucun des deux côtés ne compte. Utilisez cet endpoint pour savoir quelle part du trafic de recherche vient de personnes qui connaissent déjà la marque et quelle part vient de recherches de découverte, et suivre l’évolution de chaque côté d’une période à l’autre.
project_idobligatoirepropertyun ID, une liste séparée par des virgules ouallrangefromtosearch_typefiltersdata_statefinal|allaggregation_typeauto|byPage|byProperty
GET/search_console/ai_visibility_gaps
Les principales requêtes de la propriété, rapprochées des prompts du projet. Une requête correspond à un prompt de même texte (match_type prompt) ou, à défaut, à un prompt dont les réponses de l’IA ont lancé cette même recherche sur la période (match_type fan_out). Les deux correspondances sont exactes : le même texte une fois les deux passés en minuscules, les accents supprimés, les espaces réduits et la ponctuation de début ou de fin retirée. Seuls certains modèles indiquent leurs recherches, principalement ChatGPT. Une requête associée inclut les réponses de l’IA du prompt (responses) et son taux de mention sur la même période. Avec unmatched_only, l’endpoint liste la demande de recherche qu’aucun prompt ne couvre encore. Utilisez-le pour repérer les recherches à forte demande que le suivi IA ne couvre pas encore, les meilleures candidates à ajouter comme prompts, et pour vérifier si les requêtes qui apportent du trafic Google font aussi mentionner la marque dans les réponses de l’IA.
project_idobligatoirepropertyun ID, une liste séparée par des virgules ouallrangefromtomin_impressions100 par défautunmatched_onlytrue|falsepageper_pagesearch_typefiltersdata_statefinal|allaggregation_typeauto|byPage|byPropertyoutputflat|csv