DocsIntegrations

Google Search Console

Connecting Google Search Console unlocks measured demand tiers and page-level citation tracking for your own pages, with read-only access and a domain gate.

Connecting Google Search Console (GSC) lets MentionFlow ground its demand estimates in your real search data and track citations at the page level — but only for pages you own.

What it does

A connected GSC property unlocks two things:

  • Measured demand tiers — prompt-volume evidence backed by queries that appear in your own Search Console data.
  • Page-level citation tracking for your own pages.

How to use it

Connect from Settings:

  1. An owner or admin authorizes read-only Search Console access. The OAuth state is HMAC-signed with a 15-minute TTL.
  2. Pick a property. A property is rejected unless it covers your brand's domain — attaching another site would corrupt the project's search metrics, so the gate refuses it.

Disconnecting or switching deletes the stored GSC data and demotes any "measured" prompt-volume evidence, so the app never serves numbers it can no longer stand behind.

How it's computed

  • The GSC join only happens for your own pages when a property is connected. Without a connection, the relevant tiles show em-dashes.
  • The window is a 30-day cutoff labelled "28d" because Search Console lags about 3 days; the label reflects the data you can actually stand behind.
  • Average position is impression-weighted and is null with zero impressions.
  • Striking distance = queries ranked 8–20 with impressions above zero — the pages close enough to move.

Competitor pages never receive GSC numbers, by design. See how MentionFlow handles missing data for why demoted evidence reverts to an em-dash.

Limits

  • Needs Google OAuth credentials configured.
  • Owner/admin only can connect.
  • Competitor pages never receive GSC numbers — this is a design decision, not a gap.