ga4-api

Google Analytics 4 Data API Skill

Fetch and process data from the GA4 Data API v1.

Quick Start

All scripts:

• Save raw JSON and processed CSV to ./output/ (override with --output-dir)
• Return JSON with {"output_files": [...], "summary": "..."}

Core Operations

Standard Reports

Fetch GA4 data with flexible dimensions and metrics:

python skills/ga4-api/scripts/run_report.py \
  --property-id 123456789 \
  --start-date 2025-01-01 \
  --end-date 2025-01-07 \
  --dimensions date,sessionSource,sessionMedium \
  --metrics sessions,totalUsers,conversions \
  --row-limit 10000

Common dimension combinations:

• date - Daily trends
• sessionSource,sessionMedium - Traffic sources
• pagePath - Top pages
• country,city - Geographic breakdown
• deviceCategory - Device types
• eventName - Event analysis

Optional filters:

--dimension-filter 'country equals US' \
--metric-filter 'sessions greaterThan 100'

Date range comparison:

--compare-start 2024-12-25 \
--compare-end 2024-12-31

Batch Reports

Run multiple reports in a single API call:

python skills/ga4-api/scripts/batch_reports.py \
  --property-id 123456789 \
  --config-file reports_config.json

Config file format:

{
  "date_range": {"start": "2025-01-01", "end": "2025-01-07"},
  "reports": [
    {"name": "traffic_sources", "dimensions": ["sessionSource"], "metrics": ["sessions", "totalUsers"]},
    {"name": "top_pages", "dimensions": ["pagePath"], "metrics": ["screenPageViews", "averageSessionDuration"]}
  ]
}

Realtime Reports

Fetch real-time data (last 30 minutes):

python skills/ga4-api/scripts/realtime_report.py \
  --property-id 123456789 \
  --dimensions unifiedScreenName \
  --metrics activeUsers

Pivot Reports

Create pivot table reports:

python skills/ga4-api/scripts/pivot_report.py \
  --property-id 123456789 \
  --start-date 2025-01-01 \
  --end-date 2025-01-07 \
  --dimensions sessionSource,sessionMedium \
  --pivot-dimension deviceCategory \
  --metrics sessions