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

# GetForecast
Возвращает сформированный прогноз показов, кликов и затрат по его идентификатору.
Для метода существует версия [GetForecast (Live)](https://yandex.ru/dev/direct/doc/dg-v4/live/GetForecast.html).


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

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

```javascript
{
   "method": "GetForecast",
   "param": (int)
}
```

В параметре `param` указывают идентификатор, полученный в ответе метода [CreateNewForecast](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/CreateNewForecast.md). Идентификатор можно также узнать с помощью метода [GetForecastList](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/GetForecastList.md).


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

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

```javascript
{
   "data": {
      /* GetForecastInfo */
      "Phrases": [
         {  /* BannerPhraseInfo */
            "Phrase": (string),
            "IsRubric": (string),
            "Min": (float),
            "Max": (float),
            "PremiumMin": (float),
            "PremiumMax": (float),
            "Shows": (int),
            "Clicks": (int),
            "FirstPlaceClicks": (int),
            "PremiumClicks": (int),
            "CTR": (float),
            "FirstPlaceCTR": (float),
            "PremiumCTR": (float)
         }
         ...
      ],
      "Common": {
         /* ForecastCommonInfo */
         "Geo": (string),
         "Min": (float),
         "Max": (float),
         "PremiumMin": (float)
         "Shows": (int),
         "Clicks": (int),
         "FirstPlaceClicks": (int),
         "PremiumClicks": (int),
      }
   }
}
```

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


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

||
**<sub >Объект GetForecastInfo</sub>**
||
||
`Phrases`
|
Массив объектов `BannerPhraseInfo`. Каждый объект содержит прогноз по одной фразе, указанной при формировании отчета (метод [CreateNewForecast](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/CreateNewForecast.md)).
||
||
`Common`
|
Объект `ForecastCommonInfo` с суммарным прогнозом по всем фразам.
||

||
**<sub >Объект BannerPhraseInfo</sub>**
||
||
`Phrase`
|
Ключевая фраза, для которых составлен прогноз.
||
||
`IsRubric`
|
Признак того, что фраза является рубрикой Яндекс Каталога. Всегда содержит значение No.
||
||
`Min`
|
Средневзвешенная цена клика в нижнем блоке на момент составления прогноза, у. е.
||
||
`Max`
|
Средневзвешенная цена клика на первом месте в нижнем блоке на момент составления прогноза, у. е.
||
||
`PremiumMin`
|
Средневзвешенная цена клика в спецразмещении на момент составления прогноза, у. е.
||
||
`PremiumMax`
|
Средневзвешенная цена клика на первом месте в спецразмещении на момент составления прогноза, у. е.
||
||
`Shows`
|
Возможное количество показов объявления по данной фразе за прошедший месяц.
||
||
`Clicks`
|
Возможное количество кликов по объявлению в нижнем блоке (кроме первого места) за прошедший месяц.
||
||
`FirstPlaceClicks`
|
Возможное количество кликов по объявлению на первом месте в нижнем блоке, за прошедший месяц.
||
||
`PremiumClicks`
|
Возможное количество кликов по объявлению в спецразмещении за прошедший месяц.
||
||
`CTR`
|
CTR при показе в нижнем блоке, в процентах. Рассчитывается по формуле:

`Clicks/Shows * 100`
||
||
`FirstPlaceCTR`
|
CTR при показе на первом месте в нижнем блоке. Рассчитывается по формуле:

`FirstPlaceClicks/Shows * 100`
||
||
`PremiumCTR`
|
CTR при показе в спецразмещении. Рассчитывается по формуле:

`PremiumClicks/Shows * 100`
||

||
**<sub >Объект ForecastCommonInfo</sub>**
||
||
`Geo`
|
Список регионов, которые указаны при формировании отчета (метод [CreateNewForecast](https://yandex.com/dev/direct/doc/dg-v4/ru/reference/CreateNewForecast.md)).
||
||
`Min`
|
Стоимость кликов при показе в нижнем блоке (кроме первого места) суммарно по всем указанным фразам, у. е.
||
||
`Max`
|
Стоимость кликов при показе на первом месте в нижнем блоке суммарно по всем указанным фразам, у. е.
||
||
`PremiumMin`
|
Стоимость кликов при показе в спецразмещении суммарно по всем указанным фразам, у. е.
||
||
`Shows`
|
Возможное количество показов объявления суммарно по всем фразам.
||
||
`Clicks`
|
Возможное количество кликов в нижнем блоке (кроме первого места) суммарно по всем указанным фразам.
||
||
`FirstPlaceClicks`
|
Возможное количество кликов на первом месте в нижнем блоке суммарно по всем указанным фразам.
||
||
`PremiumClicks`
|
Возможное количество кликов в спецразмещении суммарно по всем указанным фразам.
||
|#