Documentation
Developer reference
Management API
Management of Yandex.Direct clients
Reporting API v1

Quotas

In order to ensure maximum availability of the service, Yandex.Metrica imposes limitations on the rate of API requests from users.

Two types of limitations are used simultaneously:

  • By IP — defines the maximum number of requests per second from a single IP address, which is 30.
  • By user_login — restricts the number of requests per day from the same user, which is 5000.

The rate of requests is calculated separately for each of the following groups of API methods:

  • ClientRead - reading parameters for a counter or a Yandex.Metrica user account. All methods in the Management API are assigned to this group.
  • ClientWrite - saving parameters for a counter or a Yandex.Metrica user account.
  • ReportRead - getting data from Yandex.Metrica reports. This group includes methods in the Reporting API, the report builder, and the API that is compatible with the Google Analytics Core Reporting API.

Exceeding quotas

If quotas are exceeded, all further actions by the user are temporarily blocked. The API returns a response with the HTTP status 403 Forbidden. The response body contains information about the type of quota exceeded.

When an IP quota is exceeded, the user is unblocked when the number of API requests in the last minute is less than 30.

When a user_login quota is exceeded, the user is unblocked automatically at midnight Moscow time.