Деякі функції обмежені.
Вхід Реєстрація

Ми використовуємо файли 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"
        }
    ]
}