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

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

Визначення завдання на зняття видачі за ключовими фразами (tasks.addTask)

Метод tasks.addTask дозволяє визначити завдання на зняття видачі за ключовими фразами.

Загальні параметри запиту та інструкція щодо використання Serpstat API

Параметри запиту
Параметр Опис Тип даних Опціональний Значення за замовчуванням Варіанти значень
id Ідентифікатор поточного запиту, можна вказати вручну чи визначити автоматично string ні 1, test
method Ім'я методу string ні   tasks.addTask
params Об'єкт з параметрами object ні
keywords Ключові фрази, за якими буде проходити зняття видачі string ні
"iphone,iphone X,iphone 10"
se_id

Ідентифікатор пошукової системи

int ні 1 — Google
2 — Yandex
country_id Ідентифікатор країни
Відповідність країні (за Google) зазначено в документі
int ні За обраною Yandex — вказуємо за замовчуванням 1, оскільки країна не важлива (Yandex враховує як обов'язкове налаштування лише значення міста). 23 (USA)
region_id

Ідентифікатор регіону чи міста.
Відповідність регіону зазначено в документі

int так  Google;
ні — Yandex
21176 (Texas)
lang_id

Ідентифікатор мови.
Відповідність мові зазначено в документі.

int так За замовчуванням враховують мову країни 1 (англійська)
type_id

Тип пристрою

int так Desktop 1 — Desktop
2 — Mobile

Параметри відповіді
Параметр Опис
id Відповідно до ідентифікатора запиту
result Містить в собі відповідь
task_id
Ідентифікатор задачі для отримання результату
blocked_keywords Ключові фрази зі спецсимволами, що не були враховані, ліміти за них не знімають

Можливі помилки
Значення Опис
You have no keywords after filtrating, blocked keywords: [список заблокованих ключів] Немає валідних (відповідних до правил) ключових фраз
Required parameter '[параметр]' missed Немає обов’язкового параметру
Task (id=x) with such parameters has already been created today Завдання з такими параметрами сьогодні створювали
No such se_id Невалідний ідентифікатор пошукової системи (se_id)
device_type_id
Invalid type id value
Невалідний тип пристрою(type_id)
Not enough money. You lack N$ Спроба визначити завдання на більшу кількість лімітів, ніж є на рахунку

Example
Request data:
{
    "id": "some_id",
    "method": "tasks.addTask",
    "params": {
        "keywords": "iphone,iphone X,iphone 10",
        "typeId": 1,
        "seId": 1,
        "countryId": 23,
        "regionId": 21176,
        "langId": 1
    }
}
Response data:
{
    "id": "some_id",
    "result": {
        "task_id": "2071484",
        "blocked_keywords": []
    }
}