Постановка задачи на снятие обычной и локальной выдачи по ключевым фразам

Метод 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
Локальная (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: ссылка