В пятой версии API Яндекс.Директа появился сервис Reports, который предназначен для получения статистики по аккаунту рекламодателя.
Запрос на формирование отчета следует передавать по протоколу HTTPS методом POST.
Параметры отчета необходимо указывать в теле запроса в формате XML. XML должен соответствовать XSD-схеме, размещенной по адресу: https://api.direct.yandex.com/v5/reports.xsd. См. раздел Запрос: спецификация отчета.
Отчет формируется в формате TSV. См. раздел Ответ: описание полей.
Данные передаются в кодировке UTF-8.
В зависимости от HTTP-заголовков, типа отчета и объема данных в отчете, сервер Директа может сформировать отчет в режиме онлайн или офлайн. См. раздел Онлайн- и офлайн-отчет.
Напоминаем, Яндекс.Директ начал запланированный переход на сервисы API 5 летом 2016 года. Среди ключевых особенностей API 5, можно назвать наличие отдельных веб-сервисов для операций с разными классами объектов, у каждого из которых есть свой унифицированный набор методов. Такая архитектура позволяет работать только с нужными наборами данных, не выгружая все связанные с ними дополнительные параметры, и легко встраивать новые функции с поддержкой обратной совместимости.