Search Analytics

La liste des méthodes associées à cette ressource est présentée au bas de la page.

Représentations de la ressource

Aucune donnée persistante n'est associée à cette ressource.

Méthodes

query

Interrogez les données sur le trafic de recherche grâce aux filtres et aux paramètres que vous définissez. La méthode renvoie zéro ou plusieurs lignes regroupées par les clés (dimensions) de ligne que vous définissez. Vous devez définir une plage de dates d'un ou plusieurs jours.

Lorsque la date fait partie de l'attribut, les jours sans données sont omis de la liste des résultats. Pour savoir quels jours contiennent des données, lancez une requête sans filtres regroupés par date, pour la plage de dates d'intérêt.

Les résultats sont triés par ordre décroissant du nombre de clics. Si deux lignes présentent le même nombre de clics, elles sont triées de manière arbitraire.

Consultez l'exemple Python pour appeler cette méthode.

L'API est limitée par les limites internes de la Search Console et ne garantit pas de renvoyer toutes les lignes de données, mais les premières.

Découvrez les limites concernant la quantité de données disponibles.

Exemple de requête JSON POST :
POST https://www.googleapis.com/webmasters/v3/sites/https%3A%2F%2Fwww.example.com%2F/searchAnalytics/query?key={MY_API_KEY}
{
  "startDate": "2015-04-01",
  "endDate": "2015-05-01",
  "dimensions": ["country","device"]
}