Introduction

The Logs API can be used to retrieve non-aggregate data collected by Yandex Metrica. This API is designed for users looking to process statistical data on their own to tackle their specific analytical challenges.

You can store and manage the retrieved data using ClickHouse.

To use the API, get an authorization token. It must be included in every API request. Quotas are consumed with each request, and if they are exceeded, further user actions are temporarily blocked.

For one Yandex Metrica tag, the total size of data transmitted in requests (including logs not deleted from storage) is 10 GB.

Note. Statistical information for the current day is not available, because it may be incomplete. We recommend requesting data for the previous day and earlier periods.

Questions and answers

How come data in the Logs API can be different from that in the Yandex Metrica web interface?

This might happen because the interface employs extra data processing algorithms. For example, this includes using anti-fraud algorithms, detecting the quality of conversions and clicks, and accounting for bids.

Fields where bids apply
Field Bid
ym:s:purchaseRevenue 1 (also used in Reports API v1).
ym:s:goalsPrice 1000
ym:s:productsPrice 1,000,000
ym:s:impressionsProductPrice
ym:s:purchaseTax
Field Bid
ym:s:purchaseRevenue 1 (also used in Reports API v1).
ym:s:goalsPrice 1000
ym:s:productsPrice 1,000,000
ym:s:impressionsProductPrice
ym:s:purchaseTax