Limits and Quotas on API Requests

This document describes the limits and quotas of requesting the Management APIs and Reporting APIs.

Google Analytics is used by millions of sites. We put limits and quotas on API requests to protect the system from receiving more data than it can handle, and to ensure an equitable distribution of the system resources. The limits and quotas are subject to change.

This video discusses the best practices for managing Google Analytics API request quotas.

General quota limits

The following quotas apply to Management API, Core Reporting API v3, MCF Reporting API, Metadata API, User Deletion API, and Real Time Reporting API:

  • 50,000 requests per project per day, which can be increased.
  • 10 queries per second (QPS) per IP address.
    • In the API Console, there is a similar quota referred to as Requests per 100 seconds per user. By default, it is set to 100 requests per 100 seconds per user and can be adjusted to a maximum value of 1,000. But the number of requests to the API is restricted to a maximum of 10 requests per second per user.
    • If your application makes all API requests from a single IP address (i.e., on behalf of your users), use the userIP or quotaUser parameter with each request to get full QPS quota for each user. See the standard query parameters summary for details.

Reporting APIs

The following quotas apply to all Reporting APIs, including the Core Reporting API v3, Analytics Reporting API v4, Real Time API v3, and Multi-channel Funnel API v3:

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

Reporting APIs request errors

If your request to the Reporting API fails and you get a response code 500 or 503, you can resubmit it. Google Analytics allows:

  • 10 failed requests per project per profile per hour
  • 50 failed requests per project per profile per day

If the number of your failed requests exceeds these quotas, you'll get the following error:

Quota Error: The number of recent failed writes is too high.

Instead of continuously resubmitting a failed request, implement exponential backoff to resubmit it.

Analytics Reporting API v4

These quotas apply to the Analytics Reporting API v4 only:

  • Number of requests per day per project: 50,000
  • Number of requests per view (profile) per day: 10,000 (cannot be increased)
  • Number of requests per 100 seconds per project: 2,000
  • Number of requests per 100 seconds per user per project: 100 (can be increased in Google API Console to 1,000).

You can view your project's quotas in Google API Console.

Resource Based Quota

The Analytics Reporting API v4 is also governed by the optional Resource Based Quota which allows using higher sampling thresholds for Analytics 360 customers.

Exceeding quota limits

If the quota of requesting a Google Analytics API is exceeded, the API returns an error code 403 or 429 and a message that the account has exceeded the quota. See the terms of service for more information.

Requesting additional quota

You can only request to increase:

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

  1. If you don't already have a billing account for your project, then create one.
  2. Visit the Enabled APIs page of the API library in the API Console, and select an API from the list.
  3. To view and change quota-related settings, select Quotas. To view usage statistics, select Usage.

To request an increase of the maximum quota amount, please use the Analytics API quota request form. Make sure to review the information and follow the instructions in the quota request form before submitting the request. For Reporting API v4, the API name in Google API Console is Google Analytics Reporting API. All other v3 APIs (e.g., Management API v3, Core Reporting API v3, Real Time Reporting API v3, User Deletion API v3) are listed under Analytics API in Google API Console.

For more information on quota management and how to fine-tune your application for quota usage, see Monitoring APIs and capping usage.