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

Метод: 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