---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.2
alternate:
  - https://yandex.com/dev/direct/doc/dg-v4/en/reference/GetWordstatReportList.md
  - https://yandex.com/dev/direct/doc/dg-v4/ru/reference/GetWordstatReportList.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/dg-v4/ru/llms.txt

# GetWordstatReportList
Возвращает список сформированных и формируемых отчетов о статистике поисковых запросов.
Метод используют для проверки готовности отчета с интересующим идентификатором. Также с помощью метода получают идентификаторы отчетов, чтобы затем удалить отчеты (метод [DeleteWordstatReport](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/DeleteWordstatReport.md)).

## Ограничения

Не рекомендуется вызывать метод слишком часто. Формирование отчетов занимает в среднем одну минуту, поэтому достаточная частота вызовов для проверки готовности отчета — раз в 10-20 секунд.


## Входные данные {#input}

Ниже показана структура входных данных в формате JSON. Метод не имеет входных параметров.

```javascript
{
   "method": "GetWordstatReportList"
}
```


## Результирующие данные {#output}

Метод возвращает массив объектов `WordstatReportStatusInfo`, каждый из которых содержит сведения об одном отчете. Всего в массиве может присутствовать до пяти объектов. Массив отсортирован по убыванию `ReportID`.

Ниже показана структура результирующих данных в формате JSON.

```javascript
{
   "data": [
      {  /* WordstatReportStatusInfo */
         "ReportID": (int),
         "StatusReport": (string)
      }
      ...
   ]
}
```

Ниже приведено описание параметров.


#|
||
**<sup >Параметр</sup>**
|
**<sup >Описание</sup>**
||

||
**<sub >Объект WordstatReportStatusInfo</sub>**
||
||
`ReportID`
|
Идентификатор отчета о статистике поисковых запросов.
||
||
`StatusReport`
|
Состояние отчета:

- Done — отчет сформирован;
- Pending — отчет формируется;
- Failed — сформировать отчет не удалось.
||
|#

