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

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

Примітка: результати Google AI Overview в даний момент доступні в рамках стандартних запитів Парсингу топу (для Desktop версії) без додаткової плати. Це дозволяє отримувати вміст блоку AI Overview в рамках отриманих результатів Google. Однак з 1 серпня 2025 року отримання вмісту блоку AI Overview стане окремим необов'язковим параметром за додатковою ціною. Після цієї дати необхідно буде включати отримання AI Overview в рамках запитів API та враховувати додаткові витрати на такий тип запитів.

Загальні параметри запиту та інструкція щодо використання 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
Локальна (local) видача У видачі Google в блоці Local pack при відкритті всіх результатів показується місцева (local) видача з картою, де відображаються блоки з інформацією щодо бізнесу/громадські місця. Щоб отримати ці дані (max 50 результатів), у запиті необхідно додати наступний параметр:
type	Тип видачі	string	так	За замовчуванням значення "regular" — звичайна видача; "local" — для місцевих результатів	local
Приклад запиту для Local видачі: `{ "id": "some_id", "method": "tasks.addTask", "params": { "keywords": "pizza, burger, iphone", "typeId": 1, "seId": 1, "countryId": 23, "regionId": 21176, "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)
Not enough money. You lack N$	Спроба визначити завдання на більшу кількість лімітів, ніж є на рахунку

Example Python

Request data:

{
    "id": "some_id",
    "method": "tasks.addTask",
    "params": {
        "keywords": "pizza, burger, iphone",
        "typeId": 1,
        "seId": 1,
        "countryId": 23,
        "regionId": 21176,
        "langId": 1
    }
}

Response data:

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

Шаблони запитів до Serpstat API: посилання