Query guidelines and sample queries (2025)

Table of Contents

Best practices for bulk data export queries Always use aggregation functions Limit queries by date to save processing costs Filter out null query strings Sample queries Results by site Results by URL Was this helpful? References

Best practices for bulk data export queries

Always use aggregation functions

Data in the tables is not guaranteed to be consolidated by date, URL, site, or any combination of keys. Therefore you should always aggregate your fields (SUM, COUNT, and so on) to guarantee that your row values are consolidated. For example, a table might have several rows with the query "fat cats":

Limit queries by date to save processing costs

Remember that when you run a query on BigQuery you will be charged for it, and your tables can become quite large. The tables exported are date-partitioned, which allows for efficient limiting of the input scan to only days of interest - for large sites this can translate into real savings in query cost.A good way to minimize query costs is to use a WHERE clause to limit the date range in the date partitioned table.

Filter out null query strings

Anonymized queries often make up the single most common query for a site. An anonymized query is reported as a zero-length string in the table. If you want to see the most popular query for specific criteria, you probably want to filter out zero-length query values from your SQL query.

Sample queries

Below are some sample queries to help you get up and running with the data.

Results by site

All web stats, by day (last two weeks)

SELECT data_date AS date, sum(impressions) AS impressions, sum(clicks) as clicks, sum(clicks) / sum(impressions) AS ctr, /* Added one below, because position is zero-based */ ((sum(sum_top_position) / sum(impressions)) + 1.0) AS avg_positionFROM searchconsole.searchdata_site_impressionWHERE search_type = 'WEB' AND data_date between DATE_SUB(CURRENT_DATE(), INTERVAL 14 day) and CURRENT_DATE()GROUP BY data_dateORDER BY date desc LIMIT 1000

Top USA mobile web queries by clicks (last two weeks)

SELECT query, device, sum(impressions) AS impressions, sum(clicks) AS clicks, sum(clicks) / sum(impressions) AS ctr, ((sum(sum_top_position) / sum(impressions)) + 1.0) AS avg_positionFROM searchconsole.searchdata_site_impressionWHERE search_type = 'WEB' AND country = 'usa' AND device = 'MOBILE' AND data_date between DATE_SUB(CURRENT_DATE(), INTERVAL 14 day) and CURRENT_DATE()GROUP BY 1,2ORDER BY clicksLIMIT 1000

Results by URL

Top Discover URLs by clicks (on a specific day)

SELECT url, sum(impressions), sum(clicks) FROM searchconsole.searchdata_url_impressionWHERE search_type = 'DISCOVER' AND data_date = DATE(2022, 02, 01)GROUP BY urlORDER BY 3LIMIT 1000

Total query+url stats for FAQ rich results (last two weeks)

SELECT url, query, sum(impressions) AS impressions, sum(clicks) AS clicks, sum(clicks) / sum(impressions) AS ctr, ((sum(sum_position) / sum(impressions)) + 1.0) AS avg_positionFROM searchconsole.searchdata_url_impressionWHERE search_type = 'WEB' AND is_tpf_faq = true AND data_date between DATE_SUB(CURRENT_DATE(), INTERVAL 14 day) and CURRENT_DATE()GROUP BY 1,2 ORDER BY clicksLIMIT 1000

All your traffic by URL (last two weeks)

SELECT url, search_type, sum(impressions) as impressions, sum(clicks) as clicksFROM searchconsole.searchdata_url_impressionWHERE data_date between DATE_SUB(CURRENT_DATE(), INTERVAL 14 day) and CURRENT_DATE()GROUP BY 1,2ORDER BY 3 descLIMIT 1000

Impressions for queries containing "your_brand" (last two weeks)

SELECT regexp_contains(query, 'your_brand') AS contains_brand, sum(impressions) AS impressions, sum(clicks) AS clicksFROM searchconsole.searchdata_url_impressionWHERE search_type = 'WEB' AND data_date between DATE_SUB(CURRENT_DATE(), INTERVAL 14 day) and CURRENT_DATE()GROUP BY 1ORDER BY 2 descLIMIT 1000

Was this helpful?

How can we improve it?