Визначення завдання на зняття звичайної та локальної видачі за ключовими фразами
Метод tasks.addTask дозволяє визначити завдання на зняття звичайної та локальної видачі за ключовими фразами.
Загальні параметри запиту та інструкція щодо використання Serpstat API
Параметри запиту для звичайної видачі | |||||
---|---|---|---|---|---|
Параметр | Опис | Тип даних | Опціональний | Значення за замовчуванням | Варіанти значень |
id | Ідентифікатор поточного запиту, можна вказати вручну чи визначити автоматично | string | ні | 1, test | |
method | Ім'я методу | string | ні | tasks.addTask | |
params | Об'єкт з параметрами | object | ні | ||
keywords | Ключові фрази, за якими буде проходити зняття видачі | string | ні | "iphone,iphone X,iphone 10" | |
seId | Ідентифікатор пошукової системи | int | ні | 1 — Google | |
countryId | Ідентифікатор країни. Відповідність країні (за Google) зазначено в документі | int | ні | 23 (USA) | |
regionId | Ідентифікатор регіону чи міста. | int | так — Google; | 21176 (Texas) | |
langId | Ідентифікатор мови. | int | так | За замовчуванням англійська мова | 1 (англійська) |
typeId | Тип пристрою | int | так | Desktop | 1 — Desktop 2 — Mobile |
| |||||
type | Тип видачі | string | так | За замовчуванням значення "regular" — звичайна видача; "local" — для місцевих результатів | local |
|
Параметри відповіді | |
Параметр | Опис |
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$ | Спроба визначити завдання на більшу кількість лімітів, ніж є на рахунку |
{
"id": "some_id",
"method": "tasks.addTask",
"params": {
"keywords": "pizza, burger, iphone",
"typeId": 1,
"seId": 1,
"countryId": 23,
"regionId": 21176,
"langId": 1
}
}
{
"id": "some_id",
"result": {
"task_id": "2381968",
"blocked_keywords": []
}
}
Шаблони запитів до Serpstat API: посилання