Как создать задачу

Метод: add/projects_2/tasks/volumes

Метод создает задачу с указанными параметрами и отправляет ее на проверку. В результате работы метода возвращается:

  • ID задачи, если проверка частоты запущена успешно;
  • 0 и текст ошибки, если задача не создана и проверка не была запущена. 
Параметр Тип Описание По умолчанию
Обязательные
url string URL задачи. Никак не влияет на результат проверки, можно указать site.com
keywords array Массив с запросами
region.searcher_key enum(0, 1)

Ключ поисковой системы. Возможные значения:

  • 0 — Yandex;
  • 1 — Google
region.key int

Ключ региона. Для разных поисковых систем список доступных регионов может быть разный.

region.type array(enum(0,1,2,3,4,5,6)) Индекс типа частоты (для Яндекс 1, 2, 3, 5 или 6, для Google всегда 3).
Необязательные
remove_special_chars boolean Вырезать из ключевых фраз плюсы, точки, запятые, апострофы, кавычки 0
no_recheck enum(0, 1, 2)

Возможные значения:

  • 0 — проверить все запросы;
  • 1 — не проверять запросы с актуальной частотой;
  • 2 — не проверять запросы с частотой.
0

В Google нельзя добавить российские регионы, Донецк и Луганск
В Google (searcher_key = 0) запрещено добавлять регионы России, Донецка и Луганска. Это связано с ограничениями со стороны Google.

Как узнать region.key?
Чтобы узнать ключ региона, выполните поиск по нашей базе регионов методом get/system_2/common/regions. Например, с помощью запроса ниже мы узнаем region key региона США для поисковой системы Google.
{
	"limit": 10,
	"searcher_key": "1",
	"search": "сша"
}

Пример JSON для запроса

Запрос отправляет поисковые запросы из массива keywords на проверку Частоты, "Частоты" и "[!Частоты]" в ПС Яндекс, регион Россия, и [Частоты] в ПС Google, регион США.

{
    "url": "site.com",
    "keywords": [
        "миксит отзывы",
        "отзывы на косметику миксит"
    ],
    "regions": [
        {
            "key": 225,
            "searcher_key ": 0,
            "types": [1, 2, 6],
},
        {
            "key": 84,
            "searcher_key ": 1,
            "types": [3],
},
    ]
}

Пример ответа

"result": 123456789