Работа с задачами

При работе с задачами можно:

  • Получить статус проверки частоты по задаче;
  • Получить список задач;
  • Получить результат проверки.

Как получить статус проверки задачи

Метод: get/projects_2/tasks/volumes/status

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

  • 0 — проверка завершена;
  • 1‑3 — проверка в процессе.
Параметр Тип Описание По умолчанию
Обязательные
project_id int ID задачи

Как получить список задач

Метод: get/projects_2/tasks

Метод возвращает список задач, созданных методом add/projects_2/tasks менее суток назад. Обязательные параметры отсутствуют. Необязательные идентичны методу get/projects_2/projects.

Как получить результат проверки

Метод: get/keywords_2/keywords

Метод является стандартным методом get/keywords_2/keywords для получения запросов и их частоты. Для ее получения укажите ID задачи в параметре project_id и добавьте дополнительное составное поле volume.

Пример запроса для получения данных по частоте по задаче, в которой для проверки были указаны ПС Яндекс, регион Москва и тип частоты 1 (общая частота без операторов):

{
	"project_id": "123456789",
	"fields": [
		"name",
		"volume:213:0:1"
	]
}
PHP

Также можно использовать метод get/positions_2/history.