Составные поля

Составное поле представляет собой такое поле, значение которого зависит от разных параметров.
Такие параметры принято называть определителями.

При выполнении запроса к API в качестве имени составного поля необходимо передавать помимо самого имени, значения его определителей, разделенных двоеточием ":".
Значения определителей должны идти в алфавитном порядке их имен.

Пример

Пример составного поля: частота ключевой фразы volume.
Данное поле присутствует в типе данных ключевое слово

Определителями поля volume являются следующие характеристики:

  • region_key - ключ региона
  • searcher_key - ключ ПС
  • type - номер формы частоты

Так будет выглядеть параметр fields для получения значения частоты в регионе Москва (213) в ПС Яндекс (0) в форме "!Ключевая !фраза" (3):

{"fields":["volume:213:0:3"]}

Так будет выглядеть параметр filters для получение ключевых фраз с такой же частотой, как в примере выше, но со значениями не менее 50:

{"filters":[{"name":"volume:213:0:3","operator":"GREATER_THAN_EQUALS","values":[50]}]}