Некоторые функции ограничены.
Вход Регистрация

Мы используем файлы cookie для обеспечения работоспособности сервиса, улучшения навигации и маркетинговых активностей Serpstat. Нажимая "Принять и продолжить", вы соглашаетесь с нашей Политика конфиденциальности

Постановка задачи на снятие выдачи по ключевым фразам, содержащим запятые (tasks.addKeywordList)

Метод tasks.addKeywordList позволяет поставить задачу на снятие выдачи по ключевым фразам, содержащим запятые.

Общие параметры запроса и инструкция по использованию Serpstat API по Парсингу топа

Параметры запроса
Параметр Описание Тип данных Опциональный Значение по умолчанию Варианты значений
id Идентификатор текущего запроса, можно указать вручную или он подставится автоматически string нет 1, test
method Имя метода string нет   tasks.addKeywordList
params Объект с параметрами object нет
keywords Ключевые фразы, содержащие запятые, по которым будет происходить снятие выдачи array нет ["samsung, iphone", "nike, adidas"]
se_id

Идентификатор поисковой системы

int нет 1 — Google
2 — Yandex
country_id Идентификатор страны. 
Соответствие страны по Google указано в документе.
int нет При выбранном Yandex —  по умолчанию 1, так как страна не имеет значения (Yandex принимает за обязательную настройку только значение города). 23 (USA)
region_id

Идентификатор региона или города.
Соответствие региону указано в документе.

int да — Google;
нет — Yandex
21176 (Texas)
lang_id

Идентификатор языка.
Соответствие языка указано в документе.

int да По умолчанию берется язык страны 1 (английский)
type_id

Тип устройства

int да Desktop 1 — Desktop
2 — Mobile

Параметры ответа
Параметр Описание
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": []
    }
}