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

Метод 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: ссылка

Поделитесь статьей с вашими друзьями

Вы уверены?

Знакомство с Serpstat

Узнайте об основных возможностях сервиса удобным способом!

Отправьте заявку и наш специалист предложит вам варианты обучения: персональную демонстрацию, пробный период или материалы для самостоятельного изучения и повышения экспертизы. Все для комфортного начала работы с Serpstat.

Имя

Email

Телефон

Будем рады вашему комментарию
Я принимаю условия Политики конфиденциальности.

Спасибо, мы сохранили ваши новые настройки рассылок.

Открыть чат технической поддержки