This document describes the Google Analytics Reporting API v4. For a detailed reference of the API, see the Reference Guide.


The Google Analytics Reporting API v4 provides programmatic methods to access report data in Google Analytics (Universal Analytics properties only). With the Google Analytics Reporting API, you can:

  • Build custom dashboards to display Google Analytics data.
  • Automate complex reporting tasks to save time.
  • Integrate your Google Analytics data with other business applications.


Google Analytics is built upon a powerful data reporting infrastructure. The Google Analytics Reporting API v4 gives you access to the power of the Google Analytics platform (Universal Analytics properties only). The API provides these key features:

  • Metric expressions

    The API allows you to request not only built-in metrics but also combination of metrics expressed in mathematical operations. For example, you can use the expression ga:goal1completions/ga:sessions to request the goal completions per number of sessions.

  • Multiple date ranges

    The API allows you in a single request to get data in two date ranges.

  • Cohorts and Lifetime value

    The API has a rich vocabulary to request Cohort and Lifetime value reports.

  • Multiple segments

    The API enables you to get multiple segments in a single request.

Next steps

Quick start guides

The following table provides a set of quick start guides to help you get up and running quickly. You will need to pick a language and an application type:

Service application Installed application Web application
Java Java
Python Python

To get a better understanding of how to use the Analytics Reporting API v4, read Creating a Report.