Search Analytics
Stay organized with collections
Save and categorize content based on your preferences.
For a list of methods for this resource, see the end of this page.
Resource representations
There is no persistent data associated with this resource.
Methods
- query
Query your search traffic data with filters and parameters that you define. The method returns zero or more rows grouped by the row keys (dimensions) that you define. You must define a date range of one or more days.
When date is one of the dimensions, any days without data are omitted from the result list. To learn which days have data, issue a query without filters grouped by date, for the date range of interest.
Results are sorted by click count descending. If two rows have the same click count, they are sorted in an arbitrary way.
See the python sample for calling this method.
The API is bounded by internal limitations of Search Console and does not guarantee to return all
data rows but rather top ones.
See limits to the amount of data available.
JSON POST Example:
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"]
}
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-07-23 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-07-23 UTC."],[[["The Search Analytics API allows you to query your website's search traffic data with custom filters and parameters, returning results grouped by specified dimensions."],["You can define date ranges for your queries, but the API might not return all data rows due to internal limitations, prioritizing top results instead."],["Results are sorted by click count in descending order, with arbitrary sorting for rows with identical click counts, and days without data are omitted from the result list."],["When querying with \"date\" as a dimension, you can identify days with data by performing a filter-less query grouped by date for the desired date range."],["The API offers a \"query\" method to retrieve search traffic data and provides a Python sample for utilizing this method."]]],[]]
