prokodo (GA4) icon

prokodo (GA4)

Query Google Analytics 4 (Data API) with a Service Account. Includes helpers for best post times and quick lists (landing pages, referrers).

Actions9

Referrers Top

AI-generated

Summary

Fetch top referrer sources for a specified Google Analytics 4 Property over a configurable lookback period, returning the top N referrers and session counts.

Inputs

  • Property ID (required) — Numeric GA4 Property ID from Admin → Property Settings (not the Measurement ID). For example: 412345678.
  • Return Property Quota — Boolean flag to include remaining API token quota info from GA4 to monitor usage; defaults to true.
  • Lookback (days) — Number of days to look back for aggregating session data; minimum 7 and maximum 365 days, default is 60.
  • Limit — Number of top referrer entries to return (the top N); default is 10.

Output shape

a single JSON object containing an array called 'list' of top referrer entries, each with source, medium, default channel group, and session count fields, along with optional 'propertyQuota' info about remaining API tokens.

The operation returns up to 'Limit' rows sorted descending by sessions for the specified property and lookback period. The property quota field is included if 'Return Property Quota' is enabled. Errors include permission issues if the service account lacks access to the property.

Discussion