Визначення завдання для отримання звичайної та локальної видачі за ключовими фразами, що містять коми

Метод tasks.addKeywordList дозволяє визначити завдання для отримання звичайної та локальної видачі за ключовими фразами, що містять коми.

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

Параметри запиту для звичайної видачі
Параметр	Опис	Тип даних	Опціональний	Значення за замовчуванням	Варіанти значень
id	Ідентифікатор поточного запиту, можна вказати вручну чи визначити автоматично	string	ні		1, test
method	Ім'я методу	string	ні		tasks.addKeywordList
params	Об'єкт з параметрами	object	ні
keywords	Ключові фрази, за якими буде проходити зняття видачі	array	ні		["samsung, iphone", "nike, adidas"]
seId	Ідентифікатор пошукової системи	int	ні		1 — Google
countryId	Ідентифікатор країни. Відповідність країні (за Google) зазначено в документі	int	ні		23 (USA)
regionId	Ідентифікатор регіону чи міста. Відповідність регіону зазначено в документі	int	так — Google		21176 (Texas)
langId	Ідентифікатор мови. Відповідність мові зазначено в документі.	int	ні		1 (англійська)
typeId	Тип пристрою	int	так	Desktop	1 — Desktop 2 — Mobile
Локальна (local) видача У видачі Google в блоці Local pack при відкритті всіх результатів показується місцева (local) видача з картою, де відображаються блоки з інформацією щодо бізнесу/громадські місця. Щоб отримати ці дані (max 50 результатів), у запиті необхідно додати наступний параметр:
type	Тип видачі	string	так	За замовчуванням значення "regular" — звичайна видача; "local" — для місцевих результатів	local
Приклад запиту для Local видачі: `{ "id": "some_id" , "method": "tasks.addKeywordList", "params": { "keywords": ["samsung, iphone", "nike, adidas"], "typeId": 1, "seId": 1, "countryId": 23, "langId": 1, "type": "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)

Example

Request data:

{
    "id": "some_id" ,
    "method": "tasks.addKeywordList",
    "params": {
         "keywords": ["samsung, iphone", "nike, adidas"],
         "typeId": 1,
         "seId": 1,
         "countryId":  23,
         "langId": 1
     }
}

Response data:

{
    "id": "some_id",
    "result": {
        "task_id": "2071492",
        "blocked_keywords": []
    }
}