Некоторые функции ограничены.
Вход Регистрация

Мы используем файлы cookie для обеспечения работоспособности сервиса, улучшения навигации и маркетинговых активностей Serpstat. Нажимая "Принять и продолжить", вы соглашаетесь с нашей Политика конфиденциальности

Получение списка задач, поставленных на снятие топа и их статуса (tasks.getList)

Метод tasks.getList позволяет получить список задач, поставленных на снятие топа и их статуса.

Общие параметры запроса и инструкция по использованию Serpstat API по Парсингу топа

Параметры запроса
Параметр Описание Тип данных Опциональный Варианты значений
id Идентификатор текущего запроса, можно указать вручную или он подставится автоматически string нет 1, test
method Имя метода string нет tasks.getList
params Объект с параметрами object нет
page Номер страницы ответа int да "page": 2
pageSize Количество результатов в ответе на страницу (от 100 до 1000) int да "pageSize": 1000

Параметры ответа
Параметр Описание
id Соответствует идентификатору запроса
result Содержит в себе ответ
task_id
Номер задачи, которая была поставлена на снятие топов
se_id
Идентификатор поисковой системы
country_id
Идентификатор страны
lang_id
Идентификатор языка
region_id
Идентификатор региона
device_type_id
Идентификатор устройства выдачи
progress
Прогресс снятия топов выдачи по задаче
keywords_count
Количество ключевых фраз, по которым снимаются топы
created_at
Дата и время, когда была поставлена задача
parsed_at
Дата и время, когда завершилось снятие топов по всем ключевым фразам задачи

Example
Request data:
{
  "id": 1,
  "method": "tasks.getList",
  "params": {
       "page": 1,
       "pageSize": 1000
    }
}
Response data:
{
    "id": "1",
    "result": [
        {
            "task_id": "2071484",
            "se_id": "1",
            "country_id": "23",
            "lang_id": "1",
            "region_id": "21176",
            "device_type_id": "1",
            "progress": "100%",
            "keywords_count": "3",
            "created_at": "2021-07-30 16:21:30",
            "parsed_at": "2021-07-30 16:25:45"
        },
        {
            "task_id": "2071492",
            "se_id": "1",
            "country_id": "23",
            "lang_id": "1",
            "region_id": "0",
            "device_type_id": "1",
            "progress": "100%",
            "keywords_count": "2",
            "created_at": "2021-07-30 16:54:54",
            "parsed_at": "2021-07-30 17:00:45"
        }
    ]
}