> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peec.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Search Console integration

> Google clicks, impressions, and position for your own pages, besides what AI engines retrieve and cite.

Connect **Google Search Console** **(GSC)** to Peec AI to view your Google Search performance alongside your AI search data. Track clicks, impressions, CTR, and average position for your pages, and identify opportunities that would otherwise be difficult to spot: pages that perform well in Google Search but are rarely used by AI models, and pages that AI models frequently cite but receive little visibility in Google Search.

You can find Google Search Console under **My website**. While AI Referrals shows the traffic your website receives from AI assistants, GSC shows how your pages perform in Google Search.

## Connect your property

To connect Google Search Console, you must be a **Project Owner** or **Company Owner** in Peec AI and have access to the relevant property in Google Search Console. If you can’t find the property you want to connect, contact the person who verified or manages the website in Google Search Console and ask them to grant you access.

1. Open **Google Search Console** under My website and start the Google sign-in.
2. Approve access when Google asks.
3. Select the properties you want Peec AI to read, then save.

> [!NOTE]
>
> Peec AI only requests read-only access to Google Search Console, meaning it can retrieve data without making any changes. Only Project Owners and Company Owners can set up or manage the connection. Viewers cannot manage the integration.

### Which property to pick

Search Console has two property types, and the choice changes what every number in this section covers. The type is shown under each property name when you select it.

* **Domain property:** Every subdomain and both protocols. If your project tracks one subdomain, the numbers here still cover the whole domain.
* **URL-prefix property:** Only the exact prefix that was verified in Google.

You can connect more than one property to a project. If you do, the property selector in the header decides which one every tab is showing. Peec AI never combines two properties into a single figure, because Google measures each one separately and a click counted against one property is not a click against another.

## Overview

Overview is the property's own performance, before anything is joined to your AI data. The date range at the top applies to every tab in the section.

**Search performance** gives you four figures for the selected period:

* **Clicks:** How many times someone clicked a link to your site in Google search results.
* **Impressions:** How many times someone saw a link to your site in Google search results.
* **Average CTR:** Clicks divided by impressions over the selected period.
* **Average position:** The average top position of your site in search results.

> [!NOTE]
>
> Average position is calculated based on the number of impressions each page receives. This means you cannot calculate it by simply averaging the positions shown in the tables below or across different dates.

**Performance over time:** Shows how clicks and impressions change over time, with the option to switch between daily, weekly, and monthly views. Each metric uses a separate axis, so focus on the trends of each line rather than comparing the distance between them.

**Top content**: Shows your top-performing search queries and pages side by side. You can sort either table by clicks, impressions, CTR, or position to identify which queries and pages drive the most traffic, reach the most users, or rank highest in Google Search.

## Findings

Both findings bring together Google Search performance and AI search data, making it easy to compare how each page performs across both. Each table includes the following columns: **Page,** **Impressions**, **Position**, **Retrievals**, **Citations**, **Last crawled,** and **Canonical.**

> [!NOTE]
>
> Retrieval and citation data come from your tracked prompts, not Google Search Console. To understand the difference between these two metrics, see [Retrieval vs. Citation](https://docs.peec.ai/research/retrieval-vs-citation.md).

### Ranking but not cited

These are pages that appear frequently in Google Search results but are rarely retrieved or cited by AI models. Since Google already indexes and ranks these pages, the gap may be related to content relevance or authority rather than technical accessibility.

Start by reviewing **Last crawled** and **Canonical**, where available, to identify any potential technical issues. Then review the page content to see how well it addresses the topics and prompts you're tracking.

### Cited but not ranking

These are pages that AI models frequently retrieve and cite but have little visibility in Google Search results. Since AI models already use these pages as sources, they may be valuable opportunities for further SEO optimization to improve their performance in Google Search.

**Last crawled** shows when Google last visited the page, while **Canonical** indicates whether Google's selected canonical URL matches the one you've specified.

These are the only two columns in this section that use Google indexing data. Both will be empty if Google hasn't reported information for the page. Since this data comes from Google's index rather than a live check of your website, it may not reflect the most recent changes to your pages.

## Queries

The query table shows all search queries reported by Google Search Console for your property. You can search for specific queries or sort the table by **Clicks**, **Impressions**, **CTR**, or **Position** to analyze their performance.

Above the table, **Top queries over time** shows how clicks change over time for up to eight queries, allowing you to compare their performance and identify trends.

> [!NOTE]
>
> Google Search Console excludes certain low-volume queries from its reports to protect user privacy. As a result, the clicks shown in the query table may not add up to the totals displayed in Overview. These clicks are excluded from the query data, not counted as zero, and cannot be recovered by viewing additional rows in the table.

## Pages

The Pages table shows all pages from your website that appeared in Google Search results, along with their **Clicks**, **Impressions**, **CTR**, and **Position**. You can also use **Top pages over time** to track and compare clicks for up to eight pages.

Since Google reports page-level data and property totals separately, the combined figures in the Pages table may not match the totals shown in Overview.

## Settings

The Settings section lets you manage your GSC connection and properties.

* **Connection:** Shows the Google account used to retrieve your Search Console data.
* **Force reauthentication:** Reconnects your Google account without changing your selected properties.
* **Properties:** Add or remove GSC properties at any time.
* **Danger zone:** Disconnecting the integration permanently deletes all associated GSC data from Peec AI.

## How to read these numbers

* **Pacific time:** Google reports data using Pacific time, and Peec AI displays it without converting it to your local time zone. This means a reporting day runs from 09:00 to 08:59 the following morning in CET.
* **About three days behind:** Google takes approximately three days to finalize search data, so figures for the most recent days may still change. The header shows the latest date included in the report.
* **Your property only:** Google Search Console only provides data for websites you've verified and have access to. As a result, this data is not included in Share of Voice calculations, competitor comparisons, or benchmarks.
* **Google web search, all surfaces:** The data includes Google's traditional search results and AI-powered experiences. However, it does not distinguish between regular search results, AI Overviews, and AI Mode.
* **Rare queries are excluded:** Google omits certain low-volume queries to protect user privacy. See the note under Queries for more details.
* **Average position:** Google calculates average position based on the number of impressions at each reporting level. As a result, positions shown in one table cannot be directly combined to calculate the averages in another.

> [!NOTE]
>
> Peec AI saves all data retrieved from GSC. While Google only retains search data for 16 months, Peec AI continues building your historical data from the date you connect your account.
>
> If you see an empty period at the beginning of a chart, it means GSC wasn't connected during that time.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.