Skip to main content

Google Search Console Integration

Google Search Console (GSC) is the foundation of the Minorank data pipeline. Once connected, Minorank syncs keyword positions, clicks, impressions, and CTR for every URL on the client's site — giving you a complete picture of organic search performance.

Connecting Google Search Console​

Prerequisites​

  • A Google account with Owner or Full User access to the GSC property
  • The GSC property must be verified (either domain or URL-prefix)

Steps​

  1. In the client sidebar, navigate to Integrations → Search Console.
  2. Click Connect Google Search Console.
  3. An OAuth window opens. Sign in with the Google account that has access to the client's GSC property.
  4. Grant Minorank read access to Search Console (no write permissions are requested).
  5. Select the correct property from the dropdown. Be careful if the client has multiple properties — choose the one that matches the primary domain.
  6. Click Save integration.

Minorank immediately begins a historical sync. The first sync fetches up to 16 months of data and typically completes within a few minutes, depending on the volume of queries.

:::note One GSC property per client Each Minorank client can be connected to one GSC property. If the client has multiple domains, add them as separate clients or additional sites within the same client. :::

Data available from GSC​

Once connected, the following metrics are available across the platform:

MetricDescription
ClicksThe number of times users clicked through to the site from Google search results
ImpressionsThe number of times a URL appeared in search results
CTRClick-through rate — clicks divided by impressions, expressed as a percentage
Average positionThe average ranking position across all queries and dates in the selected range

Data is broken down by:

  • Query (keyword)
  • Page (URL)
  • Device (desktop, mobile, tablet)
  • Country
  • Date

Daily sync​

Minorank syncs GSC data daily at 06:00 UTC. Because Google delays Search Console data by 2–3 days, the freshest data available on any given day is typically from 2–3 days prior.

You can trigger a manual sync from Integrations → Search Console → Sync now if you need to refresh data outside the daily window.

Filtering data​

In most GSC-powered views (Queries, Pages, Traffic trends), you can filter by:

  • Date range — presets: 7 days, 28 days, 3 months, 6 months, 12 months, 16 months; or custom
  • Device — desktop, mobile, tablet, or all
  • Country — filter to a specific country if the client targets multiple markets
  • Query — keyword-level filter (partial match)
  • Page — URL-level filter (partial match)

Brand vs non-brand breakdown​

The Brand vs non-brand section in SEO reports and the Queries view automatically segments keywords:

  • Branded — queries containing the client's brand name or common brand variations
  • Non-branded — all other queries

Minorank uses the client's domain and name (set in client settings) to build the brand keyword list. You can manually adjust the list under Settings → Brand keywords.

Troubleshooting​

"No data available" after connecting

  • Confirm the GSC property is verified and has at least one day of data.
  • Check that you authorised with the correct Google account. Re-authorise via Integrations → Search Console → Re-connect.

Wrong property selected

Disconnect and reconnect: Integrations → Search Console → Disconnect, then follow the connection steps again and select the correct property.

Data looks different from the GSC dashboard

Minorank uses the GSC API with the same filters. Small discrepancies can occur due to data sampling at high query volumes. For very high-traffic sites, contact support.

Next steps​