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

Метод 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 Python

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": []
    }
}

Шаблоны запросов к Serpstat API: ссылка