Hide

Configuration and Reporting API Limits and Quotas

This document describes the limits and quotas for the Management API, Core Reporting API, MCF Reporting API, and Real Time Reporting API.

  1. Overview
  2. Obtaining Full Quota
  3. Limits and Quotas
    1. General Quota Limits (All APIs)
    2. Management API - Write Requests
    3. Management API - Data Import
    4. Management API - Data Upload (Cost Data)
    5. Management API - Experiments
    6. Management API - Unsampled Reports
    7. Management API - User Permissions
    8. Provisioning API - Write Requests
    9. Core Reporting API
    10. Multi-channel Funnel Reporting API
    11. Real Time Reporting API
  4. Exceeding Quota Limits
  5. Requesting Additional Quota

Overview

Google Analytics is used by millions of sites. To protect the system from receiving more data than it can handle, and to ensure an equitable distribution of system resources, certain limits have been put in place. Our policies are as follows and are subject to change.

Best Practices for Google Analytics API Quotas:

Obtaining Full Quota

To get full quota, you must register your application in the Google Developers Console. When you register a new application, you are given a unique client ID to identify each application under that project. Read the Keys, access, security, and identity section of the Developers Console guide to learn more about how client IDs identify applications.

Configuration and Reporting API Limits and Quotas

Google Analytic provides both general quotas, that are shared between APIs, as well as some API specific quotas.

General Quota Limits (All APIs)

The following quota limits are shared between the Management API, Core Reporting API, MCF Reporting API, Metadata API, and Real Time Reporting API.

  • 50,000 requests per project per day – can be increased
  • 10 queries per second (QPS) per IP.
    • In the Developers Console this quota is referred to as the per-user limit. By default, it is set to 1 query per second (QPS) and can be adjusted to a maximum value of 10. If the per-user limit is set to a value larger than 10 QPS, the Google Analytics quota policy will still take effect and limit per-user requests to 10 QPS.
    • If your application makes all API requests from a single IP address (i.e. on behalf of your users) you should consider using the userIP or quotaUser parameters with each request to get full QPS quota for each user. See the query parameters summary for details.

Management API - Write Requests

This quota applies to write requests (e.g. insert, update, patch, delete):

  • 500 write requests per project per day.

Management API - Data Import

These quotas are specific to the Uploads resource:

  • 50 upload operations per property per day.
  • Lifetime data storage limit per property:
    • 1TB (Premium).
    • 10GB (Non Premium).
  • 50 Data Sets per property.
  • 5000 uploads per property.
  • Maximum file upload size of 1GB.
  • Cost Data specific limits:
    • 100 MB per date (ga:date) per data set. For example, if you upload 50 MB of data for 2014-10-10 in one upload and 50 MB of data for 2014-10-10 in a second upload, then you will have reached the 100MB limit for 2014-10-10 for that data set.

Management API - Data Upload (Cost Data)

These quotas are specific to the deprecated Daily Uploads resource:

  • 500 upload operations per project per day
  • 20 appends per upload date (not day) per custom data source
  • 1 concurrent upload per upload date per custom data source
  • 5 MB of data per upload request

Management API - Experiments

This quota is specific to Experiments:

  • 12 Experiments per view (profile). Experiments with the following status count towards this limit: DRAFT, READY_TO_RUN, and RUNNING. Experiments that have a status of ENDED for more than one day don't count towards this limit.

Management API - Unsampled Reports

These quotas are specific to Unsampled Reports:

  • Creating unsampled reports counts against the general Write Requests quota.
  • 100 unsampled reports per day per property.

Management API - User Permissions

This quota is specific to User Permissions:

  • 100 linked accounts per user.

Provisioning API - Write Requests

This quota applies to write requests (e.g. createAccountTicket) for the Provisioning API:

  • 50 requests per project per day.

Core Reporting API and Real Time Reporting API

These quotas are specific to the Core Reporting API and Real Time Reporting API:

  • 10,000 requests per view (profile) per day
  • 10 concurrent requests per view (profile)

Multi-channel Funnel Reporting API

These quotas are specific to the MCF Reporting API:

  • 10 concurrent requests per view (profile)

Exceeding Quota Limits

If quota is exceeded, Google Analytics API returns an error for additional requests: HTTP status code 403 Forbidden and a message indicating that the specific account has insufficient quota to proceed. See the terms of service for more information.

Requesting Additional Quota

You may only increase the quota for the number of daily project requests. If you think that your application needs additional daily quota, you can request more quota.

To view or change usage limits for your project, or to request an increase to your quota, do the following:

  1. Go to the Google Developers Console.
  2. Select a project, or create a new one.
  3. In the sidebar on the left, expand APIs & auth.
  4. Click APIs.

If you have enabled billing for your project, you can see the quota percentage for each API. Selecting an API takes you to a page with overview, usage, and quota information for that API. On that page, choosing Quota lets you view and change quota-related settings. Choosing Usage provides you with usage statistics as well as response code and method information.

Please provide a brief explanation of why you need this additional quota. For more details on quota management and how to fine-tune your application for quota usage, see the Monitoring, Filtering, and Capping Usage section.