Google Analytics Data API
Browse all Google APIs✓ Official Vendor SpecAnalyticsWeb Analyticsoauth210 EndpointsREST
For Agents
Run GA4 reports — standard, batched, pivot, and realtime — and export audiences across 10 endpoints.
Use for: Run a GA4 report for sessions by source/medium for the last 30 days, Get the top events on my GA4 property today, Run a real-time report to see active users on my site right now, List all available dimensions and metrics for a GA4 property
Not supported: Does not configure GA4 properties, send measurement events, or query Universal Analytics — use for running reports on GA4 properties only.
The Google Analytics Data API is the reporting surface for GA4 properties. It runs custom reports with dimensions and metrics, batched reports across several queries, pivot reports, real-time reports, and on-demand audience exports. It also exposes a metadata endpoint that lists every dimension and metric available on a property and a checkCompatibility call that explains why a particular dimension/metric combination is not allowed. Reporting only — property configuration goes through the Admin API.
Install Jentic One Beta
Connect the Google Analytics Data API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Google Analytics Data API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Google Analytics Data API.
Run a GA4 report with dimensions, metrics, filters, and date ranges via runReport
Run several reports in parallel with batchRunReports for dashboard pages
Run pivot reports to cross dimension values for matrix-style analysis
Run a real-time report to see active users and recent events on a GA4 property
Check whether a dimension/metric combination is compatible before running a report
Read the full list of available dimensions and metrics for a property via metadata
Trigger an audience export to create a downloadable user list for a defined audience
Use Cases
Patterns agents use Google Analytics Data API for, with concrete tasks.
★ Programmatic GA4 Dashboards
Internal BI dashboards often need GA4 data alongside other warehouse data. Calling runReport from a scheduled job lets a team pull exactly the dimensions and metrics they want into a warehouse table without exporting through Looker Studio. batchRunReports reduces request overhead when a dashboard panel needs several related reports at once.
POST /v1beta/{+property}:runReport with dimensions=[date, sessionSource, sessionMedium] and metrics=[sessions, conversions], a 30-day dateRange, and write the rows to a warehouse table.
Real-Time GA4 Monitoring
Operations teams want a live view of active users when they push a release or run a campaign launch. runRealtimeReport returns active users by dimension within roughly the last 30 minutes. A small poller can wire this into a chat channel or status page so the team sees traffic shifts immediately.
POST /v1beta/{+property}:runRealtimeReport with dimensions=[country] and metrics=[activeUsers] every 60 seconds and post the breakdown to a Slack channel.
Audience Export to a CDP
Marketing teams want the user list behind a GA4 audience available in a CDP or warehouse. The audienceExports endpoint creates a long-running export job that produces a downloadable list of pseudonymous identifiers in the audience. Once the job completes, the export can be queried and forwarded to the CDP for activation.
POST /v1beta/{+parent}/audienceExports with the audience resource name, poll until the export state is ACTIVE, then GET the export to retrieve the rows.
Compatibility-First Report Building
Not every dimension and metric in GA4 can be combined in a report; some are scoped to events and others to users or sessions. Before running a report from generated SQL or a UI builder, calling checkCompatibility tells the caller exactly which fields are incompatible with the proposed combination. This stops a downstream tool from generating a runReport call that GA4 will refuse.
POST /v1beta/{+property}:checkCompatibility with the proposed dimensions and metrics and surface any INCOMPATIBLE entries in the report builder UI.
Agent-Driven GA4 Reporting
An agent integrating the Data API through Jentic can convert a natural-language question ("sessions by source last week") into a runReport call by mapping the user's terms onto the property's dimension and metric metadata. Jentic isolates the Google OAuth credential and exposes the runReport schema, so the agent stays focused on translating intent into a valid report request body.
Use the Jentic search query 'run a GA4 report' to discover /v1beta/{+property}:runReport, build the dimensions, metrics, and dateRanges from the user's question, and execute it.
Key Endpoints
10 endpoints — the google analytics data api is the reporting surface for ga4 properties.
METHOD
PATH
DESCRIPTION
POST
/v1beta/{+property}:runReport
Run a custom GA4 report
POST
/v1beta/{+property}:batchRunReports
Run several GA4 reports in one request
POST
/v1beta/{+property}:runPivotReport
Run a pivot report on a GA4 property
POST
/v1beta/{+property}:runRealtimeReport
Run a real-time report on a GA4 property
POST
/v1beta/{+property}:checkCompatibility
Validate a dimension/metric combination
GET
/v1beta/{+name}
Get metadata listing available dimensions and metrics
POST
/v1beta/{+parent}/audienceExports
Trigger an audience export
POST
/v1beta/{+property}:runReport
Run a custom GA4 report
POST
/v1beta/{+property}:batchRunReports
Run several GA4 reports in one request
POST
/v1beta/{+property}:runPivotReport
Run a pivot report on a GA4 property
POST
/v1beta/{+property}:runRealtimeReport
Run a real-time report on a GA4 property
POST
/v1beta/{+property}:checkCompatibility
Validate a dimension/metric combination
GET
/v1beta/{+name}
Get metadata listing available dimensions and metrics
POST
/v1beta/{+parent}/audienceExports
Trigger an audience export
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Data API uses OAuth 2.0 with analytics.readonly. Jentic keeps the refresh token encrypted in the MAXsystem vault and gives the agent only short-lived access tokens, so credentials stay out of agent context.
Intent-based discovery
Agents search Jentic with intents like 'run a GA4 report' or 'export a GA4 audience' and receive the matching report operation with its input schema, including dimension and metric structure.
Time to first call
Direct integration takes 1-2 days to implement OAuth, learn the dimension/metric model, and handle quota errors. Through Jentic, a working report runs in under an hour.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Google Analytics Data API through Jentic.
What authentication does the Google Analytics Data API use?
OAuth 2.0 with the analytics.readonly scope (or analytics for read-write contexts). Jentic stores the refresh token in the MAXsystem vault and provides only short-lived access tokens to the agent.
Can I run real-time reports on a GA4 property with this API?
Yes. POST /v1beta/{+property}:runRealtimeReport returns active-user and recent-event metrics for roughly the last 30 minutes, suitable for dashboards during launches or campaign pushes.
What are the rate limits for the Data API?
GA4 reporting has token-bucket quotas per property, with separate buckets for core and realtime tokens, plus per-project quotas for concurrent requests. Quota usage is returned in the response, so a job can back off when nearing the limit. See the Data API quotas page in the Cloud Console.
How do I run a GA4 sessions-by-source report through Jentic?
Search Jentic for 'run a GA4 report', load the schema for /v1beta/{+property}:runReport, and execute it with dimensions=[sessionSource] and metrics=[sessions] over the desired dateRange. Run pip install jentic and use the async search, load, execute pattern.
Does this API let me change GA4 property configuration?
No. Configuration (data streams, custom dimensions, conversion events, access) lives in the Google Analytics Admin API (analyticsadmin). The Data API is reporting only.
GET STARTED