# API Яндекс Директа v5: POST /json/v5/reports — Reports: отчёт статистики

Тело — `params` (ReportDefinition); ответ — отчёт в формате TSV. В режиме offline отчёт формируется асинхронно, заголовок ответа `retryIn` подсказывает интервал повторного запроса в секундах.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `processingMode` | header | string | нет | online, offline или auto (по умолчанию) |
| `returnMoneyInMicros` | header | string | нет | false — деньги в валюте с двумя знаками; по умолчанию × 1 000 000 |
| `skipReportHeader` | header | string | нет | true — без строки с названием отчёта |
| `skipColumnHeader` | header | string | нет | true — без строки с названиями полей |
| `skipReportSummary` | header | string | нет | true — без строки с числом строк |
| `params.SelectionCriteria` | body | object | да | Критерии отбора; DateFrom/DateTo — только при CUSTOM_DATE, Filter — необязательный |
| `params.FieldNames` | body | array | да | Поля отчёта |
| `params.ReportName` | body | string | да | Название отчёта |
| `params.ReportType` | body | string | да | Тип отчёта, например ACCOUNT_PERFORMANCE_REPORT |
| `params.DateRangeType` | body | string | да | Период, например CUSTOM_DATE |
| `params.Format` | body | string | да | Только TSV |
| `params.IncludeVAT` | body | string | да | Учитывать НДС: YES/NO |
| `params.Goals` | body | array | нет | Цели |
| `params.AttributionModels` | body | array | нет | Модели атрибуции |
| `params.Page.Limit` | body | integer | нет | Ограничение строк (обязательно внутри Page) |
| `params.OrderBy` | body | array | нет | Сортировка |

## Базовые URL

- Боевой: `https://api.direct.yandex.com`
- Тестовый (песочница): `https://api-sandbox.direct.yandex.com`
- Песочница (SOAP): `https://api-sandbox.direct.yandex.com/v5/{service}`

## Авторизация

Тип: OAuth 2.0

OAuth 2.0: приложение регистрируется заранее, OAuth-токен пользователя Директа передаётся в заголовке `Authorization: Bearer <токен>`.

## Нюансы

- Все запросы — HTTPS POST; в теле JSON всегда есть `method` и, как правило, `params`. Поддерживается и SOAP/XML.
- Ошибки уровня запроса приходят с HTTP 200 в объекте `error` (`request_id`, `error_code`, `error_string`, `error_detail`) — проверяйте наличие `error`, а не только статус.
- Ошибки отдельных объектов при `add`/`update` возвращаются в `Errors` соответствующего элемента результата.
- Заголовки ответа: `RequestId` (указывать в обращениях в поддержку), `Units` (`списано/остаток/суточный лимит`, например `10/20828/64000`), `Units-Used-Login`.
- Денежные значения в фильтрах Reports — целые числа, умноженные на 1 000 000.
- Товарные объявления работают через адрес `https://api.direct.yandex.com/v501/`.
- В песочнице действуют те же ограничения; данные удаляются через месяц после последнего обращения.

## Сценарии с этим методом

- [Выгрузить статистику рекламных кампаний](https://mcp-everything.ru/integrations/yandex-direct/scenarios/vygruzit-statistiku-reklamnyh-kampaniy.md)

---

Если этого недостаточно — официальная документация: https://yandex.ru/dev/direct/doc/ru/
Вся интеграция одним документом: https://mcp-everything.ru/integrations/yandex-direct.md