Google Integrations (GSC + GA4)

Google Integrations brings Search Console (GSC) and Google Analytics 4 (GA4) directly into Rankion. You connect your Google account once, link the matching property per project, and Rankion pulls click, impression, position, and traffic metrics into the dashboard. That complements the SERP view of the Rank Tracker with real click data, and the content view of the Content Audit with real user signals from GA4.

What it can do

• Connection management — GET /v1/google/connections lists all Google accounts connected to the team. DELETE /v1/google/connections/{id} cleanly disconnects an account, including token revoke.
• GSC property discovery — GET /v1/google/gsc/properties lists all GSC properties the connected account has access to (sitemap, domain, or URL-prefix properties).
• GSC linking per project — POST /v1/google/gsc/properties/{p}/link and DELETE .../link link / unlink a property to a Rankion project.
• GSC sync — POST /v1/google/gsc/properties/{p}/sync pulls one single day of data (clicks, impressions, CTR, position) for the property: the day three days ago. 1 credit per call, even if the job fails later.
• GSC metrics read — GET /v1/google/gsc/properties/{p}/metrics returns the most recently synced values for reporting & UI.
• GA4 property discovery & linking — analogous: GET /v1/google/ga4/properties, POST/DELETE /v1/google/ga4/properties/{p}/link.
• GA4 metrics — GET /v1/google/ga4/properties/{p}/metrics returns traffic, engagement, and conversion metrics.
• Reviews connector status — GET /v1/integrations/google/reviews/status shows whether the Google Reviews connector (part of Review Sources) is active.

When to use

• You want to marry SERP positions from Rank Tracker with real click data from GSC.
• You want to see whether content-audit findings actually move traffic (GA4).
• You want to build reporting dashboards that have GSC, GA4, and Rankion data in a single source.
• You want to feed Agentic Chat real performance data.

Workflow

1. Connect Google — the OAuth flow starts in the UI; on success, the account appears in GET /v1/google/connections.
2. List properties — GET /v1/google/gsc/properties and GET /v1/google/ga4/properties show the available properties.
3. Link property → project — POST /v1/google/gsc/properties/{p}/link with project_id, same for GA4. This starts the free backfill: 90 days via the API, 30, 90, 180 or 365 days to choose from in the connection wizard. Per project only one GSC and one GA4 property.
4. Fetch a single day (optional) — POST /v1/google/gsc/properties/{p}/sync fetches one day (three days ago), not a history. 1 credit, charged with the 202 response, no refund if the job fails later.
5. Read metrics — GET /v1/google/gsc/properties/{p}/metrics and .../ga4/.../metrics for reports, dashboards, agent tools.
6. Disconnect — DELETE /v1/google/connections/{id} revokes the OAuth token; property links are flagged as "Connection lost" in the UI.

API

Credits & Limits

• GSC sync: 1 credit per call, charged with the 202 response, no refund if the job fails later. The backfill on linking is free. Read endpoints are credit-free.
• GA4 sync: included in the read endpoints, no extra credit.
• OAuth tokens: refresh runs automatically; expired connections need to be re-authorized via the OAuth flow.
• Property cap: at most one GSC and one GA4 property per project.
• Team scoped: connections belong to the current team; cross-team → 404.

Related modules

• Rank Tracker — combines SERP position with GSC clicks and impressions.
• Content Audit — evaluates content with real traffic signals from GA4.
• Review Sources — the Google Reviews connector runs through the same OAuth flow.
• Agentic Chat — the agent can pull GSC and GA4 metrics into its analyses.
• Reports — combined GSC+GA4+Rankion reports use the data synced here.