Google Analytics Data API

Accesses report data in Google Analytics. Warning: Creating multiple Customer Applications, Accounts, or Projects to simulate or act as a single Customer Application, Account, or Project (respectively) or to circumvent Service-specific usage limits or quotas is a direct violation of Google Cloud Platform Terms of Service as well as Google APIs Terms of Service. These actions can result in immediate termination of your GCP project(s) without any warning.


To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery documents:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:


REST Resource:

batchRunPivotReports POST /v1beta/{property=properties/*}:batchRunPivotReports
Returns multiple pivot reports in a batch.
batchRunReports POST /v1beta/{property=properties/*}:batchRunReports
Returns multiple reports in a batch.
checkCompatibility POST /v1beta/{property=properties/*}:checkCompatibility
This compatibility method lists dimensions and metrics that can be added to a report request and maintain compatibility.
getMetadata GET /v1beta/{name=properties/*/metadata}
Returns metadata for dimensions and metrics available in reporting methods.
runPivotReport POST /v1beta/{property=properties/*}:runPivotReport
Returns a customized pivot report of your Google Analytics event data.
runRealtimeReport POST /v1beta/{property=properties/*}:runRealtimeReport
Returns a customized report of realtime event data for your property.
runReport POST /v1beta/{property=properties/*}:runReport
Returns a customized report of your Google Analytics event data.

REST Resource:

runFunnelReport POST /v1alpha/{property=properties/*}:runFunnelReport
Returns a customized funnel report of your Google Analytics event data.

REST Resource:

create POST /v1alpha/{parent=properties/*}/audienceLists
Creates an audience list for later retrieval.
get GET /v1alpha/{name=properties/*/audienceLists/*}
Gets configuration metadata about a specific audience list.
list GET /v1alpha/{parent=properties/*}/audienceLists
Lists all audience lists for a property.
query POST /v1alpha/{name=properties/*/audienceLists/*}:query
Retrieves an audience list of users.