---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.1
alternate:
  - https://yandex.com/dev/adfox/doc/en/rest-statistics/about.md
  - https://yandex.com/dev/adfox/doc/ru/rest-statistics/about.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/adfox/doc/en/llms.txt

# Introduction

The REST API is designed to provide statistics to account admins, assistants, and advertisers.

{% note info %}

Reports display data in the UTC+3 time zone.

{% endnote %}

## Base URL

```
https://adfox.yandex.ru/api/v2/reports
```

## Request and response formats

Parameters:

* Data format: JSON
* Encoding: UTF-8

Send the report‑generation request over HTTPS using the `GET` or `POST` method.

`POST` requests must contain the following header:

```
Content-Type: application/json
```

Successful responses return data wrapped in the `result` field:

```json
{
  "result": { ... }
}
```

Sometimes the API business logic triggers an error condition, such as a validation failure, “task not found”, or “report not ready”. When this happens, the response includes an `error` field:

```json
{
  "error": {
    "code": "UNKNOWN_METRIC",
    "message": "Unknown metric: impressions_xxx"
  }
}
```

#|
|| **Field** | **Type** | **Description** ||
|| `error` | `object` | Always present for this type of error. ||
|| `error.code` | `string` | Machine-readable code name (Latin characters, `SNAKE_CASE` for compound names). ||
|| `error.message` | `string` | Explanation in English. ||
|#

The HTTP status corresponds to `error.code` (see [Error codes](https://yandex.com/dev/adfox/doc/en/rest-statistics/error-codes.md)).

A single HTTP status may correspond to multiple `code` values.

## Limits

#|
|| **Parameter** | **Value** ||
|| Maximum report period | 365 days ||
|| Maximum number of rows per report (result) | 1,000,000 ||
|| Maximum dimensions per request | 10 ||
|| Maximum metrics per request | 10 ||
|| Maximum filters per request | 10 ||
|#

## Limits on the number of requests {#limits}

<!-- source: en/_includes/notes.md -->
{% note info %}

Report data is stored for 3 years.

{% endnote %}
<!-- endsource: en/_includes/notes.md -->

The number of requests to generate a report is limited to:

- 100 requests per minute.
- 3 simultaneous requests from one account owner.

When the reports are ready (`"status": SUCCESS`), you can send new requests.