---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/direct/doc/dg-v4/en/tasks/HowToGetReport.md
  - https://yandex.com/dev/direct/doc/dg-v4/ru/tasks/HowToGetReport.md
  - href: ru/tasks/HowToGetReport.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/ru/llms.txt

# Получение статистики

В API существует несколько методов получения статистики. Они перечислены ниже в порядке повышения объема возвращаемых данных. Чем больше данных возвращает метод, тем сильнее он нагружает API и дольше выполняется. Рекомендуется использовать наиболее простой из подходящих методов.

- [GetBalance](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/GetBalance.md)
- [GetSummaryStat](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/GetSummaryStat.md)
- [GetBannersStat (Live)](https://yandex.com/dev/direct/doc/dg-v4/ru/live/GetBannersStat.md)
- [CreateNewReport](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/CreateNewReport.md) (см. инструкцию ниже)

Ниже приведена последовательность шагов для получения подробного [отчета](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/CreateNewReport.md).

1. Сформируйте структуру [входных данных](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/CreateNewReport.md) и вызовите с ней метод [CreateNewReport](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/CreateNewReport.md).
    
    Метод возвращает идентификатор будущего отчета.
    
    <!-- source: ru/_includes/live/CreateNewReport/id-CreateNewReport/restriction.md -->
    Для одного пользователя на сервере хранится не более пяти отчетов. При попытке сформировать шестой отчет возвращается сообщение об ошибке с кодом [31](https://yandex.ru/dev/direct/doc/dg-v4/reference/ErrorCodes.md#ErrorCode31). Отчеты хранятся в течение пяти часов, а затем автоматически удаляются. С помощью метода [DeleteReport](https://yandex.ru/dev/direct/doc/dg-v4/reference/DeleteReport.html) можно удалить отчет вручную.
    <!-- endsource: ru/_includes/live/CreateNewReport/id-CreateNewReport/restriction.md -->
    
1. Периодически вызывайте метод [GetReportList](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/GetReportList.md) и проверяйте готовность отчета по его идентификатору.
    
    <!-- source: ru/_includes/reference/GetReportList/id-GetReportList/call-restriction.md -->
    Вызывать метод рекомендуется не чаще одного раза в 10-20 секунд (формирование отчета занимает в среднем одну-две минуты). Когда отчет готов, метод возвращает ссылку для скачивания файла с сервера.
    <!-- endsource: ru/_includes/reference/GetReportList/id-GetReportList/call-restriction.md -->
    
1. Скачайте файл отчета по ссылке, которую вернул метод [GetReportList](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/GetReportList.md).