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.

Paramètres :
  • project_idobligatoire
  • outputflat|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.

Paramètres :
  • project_idobligatoire
  • propertyun ID, une liste séparée par des virgules ou all
  • range
  • from
  • to
  • dimensioncountry|device|page|query|searchAppearance|property
  • limit1 000 par défaut et au maximum
  • search_typeweb|image|video|news|discover|googleNews
  • filters
  • data_statefinal|all
  • aggregation_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.

Paramètres :
  • project_idobligatoire
  • propertyun ID, une liste séparée par des virgules ou all
  • range
  • from
  • to
  • granularityday|week|month
  • search_typeweb|image|video|news|discover|googleNews
  • filters
  • data_statefinal|all
  • aggregation_typeauto|byPage|byProperty
  • outputflat|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).

Paramètres :
  • project_idobligatoire
  • propertyun ID, une liste séparée par des virgules ou all
  • range
  • from
  • to
  • sortimpressions|clicks|ctr|position
  • page
  • per_page
  • start_row
  • search_typeweb|image|video|news|discover|googleNews
  • filters
  • data_statefinal|all
  • aggregation_typeauto|byPage|byProperty
  • outputflat|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.

Paramètres :
  • project_idobligatoire
  • propertyun ID, une liste séparée par des virgules ou all
  • range
  • from
  • to
  • sortimpressions|clicks|ctr|position
  • page
  • per_page
  • start_row
  • search_typeweb|image|video|news|discover|googleNews
  • filters
  • data_statefinal|all
  • aggregation_typeauto|byPage|byProperty
  • outputflat|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.

Paramètres :
  • project_idobligatoire
  • dimensionsobligatoire, séparées par des virgules, de 1 à 3 parmi date|country|device|page|query|searchAppearance|property
  • propertyun ID, une liste séparée par des virgules ou all
  • range
  • from
  • to
  • sortimpressions|clicks|ctr|position
  • page
  • per_page
  • start_row
  • search_type
  • filters
  • data_statefinal|all
  • aggregation_typeauto|byPage|byProperty
  • outputflat|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.

Paramètres :
  • project_idobligatoire
  • propertyun ID, une liste séparée par des virgules ou all
  • range
  • from
  • to
  • min_impressions100 par défaut
  • min_position4 par défaut
  • max_position20 par défaut
  • page
  • per_page
  • search_type
  • filters
  • data_statefinal|all
  • aggregation_typeauto|byPage|byProperty
  • outputflat|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.

Paramètres :
  • project_idobligatoire
  • propertyun ID, une liste séparée par des virgules ou all
  • range
  • from
  • to
  • min_impressions100 par défaut
  • min_sharede 0.01 à 0.5, 0.1 par défaut
  • page
  • per_page
  • search_type
  • filters
  • data_statefinal|all
  • aggregation_typeauto|byPage|byProperty
  • outputflat|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).

Paramètres :
  • project_idobligatoire
  • propertyun ID, une liste séparée par des virgules ou all
  • range
  • from
  • to
  • dimensionpage|query
  • min_clicks10 par défaut
  • page
  • per_page
  • search_type
  • filters
  • data_statefinal|all
  • aggregation_typeauto|byPage|byProperty
  • outputflat|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.

Paramètres :
  • project_idobligatoire
  • propertyun ID, une liste séparée par des virgules ou all
  • range
  • from
  • to
  • search_type
  • filters
  • data_statefinal|all
  • aggregation_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.

Paramètres :
  • project_idobligatoire
  • propertyun ID, une liste séparée par des virgules ou all
  • range
  • from
  • to
  • min_impressions100 par défaut
  • unmatched_onlytrue|false
  • page
  • per_page
  • search_type
  • filters
  • data_statefinal|all
  • aggregation_typeauto|byPage|byProperty
  • outputflat|csv