Connecting Google Search Console

SEO Perception can show traffic and query context from Google Search Console (GSC) after you connect an account and add a website whose property matches the site you care about.

In the product, setup is shown as three steps; connecting a GSC account is step 1, before you add a website (step 2) and data collection (step 3). See also Getting started on the dashboard.

Before you connect in SEO Perception

The Google account you use should already have at least one Search Console property for the site you care about (added and verified in Google). If you have not set that up yet, follow Google’s help: Add a website property to Search Console first, then return here.

Property and site should match

The GSC property you authorize should correspond to the domain or URL prefix of the website you added in SEO Perception. If they do not align, metrics may be missing or misleading for that site.

When data appears

Search Console metrics are ingested and stored over time; you may not see a full history immediately after connecting. As collection runs, charts and totals fill in according to your plan’s retention. Very new properties may have limited history in GSC itself.

Crawl data and GSC data are separate pipelines: a page can be crawled before GSC has meaningful stats for it, or the reverse. The website workspace surfaces both where available.

Step-by-step: connect your Google account

You need an SEO Perception account and to be signed in. Connecting Search Console sends you to Google in the same browser tab (full-page redirect); your password is never stored by SEO Perception.

1. Open the Google Search Console accounts area in the app—the URL path is /gsc-accounts on your SEO Perception deployment.
2. Click Connect GSC Account. If you already have a connection and want another Google login, use Add Another GSC Account.
3. Google shows an account chooser. Pick the Google account that has access to your Search Console properties (often the same one you use for Analytics or Gmail for work).
4. If asked, sign in to that Google account (email and password, or your organization’s SSO flow).
5. Google shows a screen asking you to allow SEO Perception to access Search Console data on your behalf. Review what is being requested, then confirm with Allow (or the equivalent button).
6. Your browser returns to SEO Perception on /gsc-accounts/callback. On success you should see a short confirmation with the connected account and how many properties were found. After a few seconds you are taken to the dashboard (/dashboard), or you can use the button to go there immediately.
7. To review connected accounts and browse property lists anytime, open /gsc-accounts from navigation or by URL.

Tip: Complete the Google steps in the same tab and browser profile you started from. If something fails, use Try again on the callback page or reconnect from /gsc-accounts. If metrics look wrong later, double-check that the property you select when adding a website matches that Search Console property.

Related articles

• Getting started on the dashboard — the three-step guide after sign-up.
• Search Console data in SEO Perception — where stored metrics appear in the UI.
• Adding a website
• A holistic approach to SEO in SEO Perception
• How the crawler works