---
id: google-analytics-data
version: "0.23.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# google-analytics-data — Google Analytics Data API client library

License: permissive · Maintenance: active · Downloads: 6.8M/mo

## What it is and what it does

google-analytics-data is the official Python client for Google's Analytics Data API, enabling programmatic access to report data from Google Analytics properties. It wraps the underlying gRPC API with a Pythonic interface, handling authentication, serialization, and request/response marshaling through dependencies on google-api-core, google-auth, and protobuf.

Developers use it to build applications that query analytics metrics and dimensions, automate reporting workflows, or integrate analytics data into dashboards and business intelligence systems. The library requires a Google Cloud project with the Analytics Data API enabled and proper authentication credentials; it supports Python 3.10 and later versions.

Use it for:

- Automate daily or weekly analytics report generation and delivery to stakeholders without manual GA interface access.
- Build custom dashboards that pull real-time or historical analytics data and combine it with other business metrics.
- Extract analytics data for specific date ranges, segments, or properties to feed into data warehouses or analysis pipelines.
- Programmatically monitor key performance indicators and trigger alerts when metrics cross defined thresholds.
- Integrate analytics insights into internal tools, CRM systems, or marketing automation platforms.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python client library for querying Google Analytics Data API to retrieve report data from Google Analytics properties.

Yes. This is the official, actively maintained client for Google Analytics Data API with low install friction, permissive licensing, no known vulnerabilities, and broad Python version support (3.10+). Install it if you need to query Google Analytics data programmatically; it is the standard choice for this task. Prerequisite: Google Cloud project setup and authentication configuration.

## Install

pip install google-analytics-data
uv add google-analytics-data
poetry add google-analytics-data

## Installing google-analytics-data

Before you install: Low friction installation with a pure Python wheel. Actively maintained with recent releases; last commit 2026-08-14. Requires Python >= 3.10 and depends on standard Google Cloud libraries (google-api-core, google-auth, grpcio, proto-plus, protobuf).

License in practice: Licensed under Apache-2.0 (permissive), allowing use in commercial and private projects with minimal restrictions; attribution required.

Quickstart:

pip install google-analytics-data

from google.analytics.data_v1beta import BetaAnalyticsDataClient
from google.analytics.data_v1beta.types import RunReportRequest

client = BetaAnalyticsDataClient()
request = RunReportRequest(property="properties/YOUR_PROPERTY_ID")
response = client.run_report(request)

Requires Google Cloud project setup with Google Analytics Data API enabled, authentication credentials configured, and Python >= 3.10.

Verify before relying:

- Whether the library supports all current Google Analytics Data API features or a subset thereof.
- Performance characteristics when querying large datasets or high-frequency report generation.
- Whether additional setup beyond standard gcloud authentication is required for specific use cases.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 6.8M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

google analytics api client, analytics data reporting python, google analytics query library, fetch analytics reports programmatically, google analytics data extraction, analytics metrics dimensions python, google cloud analytics client, google-cloud, analytics, reporting

[View on SkillFed](https://skillfed.io/packages/google-analytics-data) · [View on PyPI](https://pypi.org/project/google-analytics-data/)