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

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

Получение результатов Парсинга Частотности V4 (SerpstatTaskProcedure.getTaskResult)

SerpstatTaskProcedure.getTaskResult  метод позволяет получить результаты Парсинга Частотности по идентификатору запроса "task_id", который был получен в ответе метода SerpstatTaskProcedure.addKeywordListFreq.

Параметры запроса:

Название параметра Описание Тип данных Опциональный Значение по умолчанию Варианты значений
taskId идентификатор запроса из ответа метода SerpstatTaskProcedure.addKeywordListFreq string нет   352ab0be-b8a4-4966-8d16-f9137cb93c23
page номер страницы int да 1  5
pageSize количество результатов на страницу  int да 100


Метрики ответа:

Название параметра Описание Тип данных
id Идентификатор запроса. Служит для обработки асинхронных запросов. int
result объект с результатами. json object
total суммарное количество ключевых фраз в задаче без учета blocked и дублей. int
page порядковый номер страницы результатов. int
pageSize количество результатов на странице. int
task_meta идентификаторы настроек парсинга json object
keywords массив ключевых фраз с информацией по каждому ключевому слову. json array of objects
keyword ключевая фраза, по которой были получены параметры частотности и стоимости за клик с учетом всех фильтров. string
keyword.raw Ключевая фраза, которая пришла на пробивку частотности от пользователя. Частотность пробивается для ключевых фраз без спецсимволов (*, +, -, @, ~, !, &, |, (, ), :, ,, ., ;). string
status статус пробивки ключевой фразы. Статусы могут быть следующие:
0- фраза записана в хранилище. Готов к отправке на парсинг
1- отправлено на пробивку частотности (в работе)
2 - пробивка частотности успешно завершена. Данные в keyword_data присутствуют.
3 - ошибка отправки в очередь.
4 - ошибка пробивки. Фраза не прошла проверку на уровне поисковой системы. Подробнее тематики ключевиков, которые не пройдут проверку описаны тут https://support.google.com/adspolicy/answer/6008942?hl=ru
string
searchVolume Частотность по выбранном региону и типу соответствия int
searchVolumeHistory История частотности по ключевой фразе за последние 12 месяцев. Каждый объект состоит из полей date (дата первого дня месяца в формате YYYY-MM-DDTHH:MM:SS) и value (месячная частотность). int
cost средняя стоимость за клик в Google Ads за последний год в USD (Минимальная стоимость размещения в премиум блоке для Яндекс) int
competition Конкуренция по ключевой фразе в Google Ads для Google ( от 1 до 100), которая показывает какой процент слотов для рекламы по этой фразе занято в данном регионе int
taskMeta объект с настройками парсинга, переданными в методе SerpstatTaskProcedure.addKeywordListFreq json object
seId Идентификатор поисковой системы:
seId=1 - Google
seId=2 - Yandex
int
typeId Идентификатор типа устройства:
typeId=1 - Desktop
typeId=2 - Mobile
typeId=2 - работает только для Яндекса. Для Google пробивка будет идти по typeId=1, независимо от указанного параметра
int
regionId Идентификатор региона или города для Google и Yandex. Соответствие региону указано в документе. Осторожно, документ тяжелый - может временно положить браузер. https://docs.google.com/spreadsheets/d/1LUDtm-L1qWMVpmWuN-nvDyYFfQtfiXUh5LIHE8sjs0k/edit#gid\u003d1732572784 int
matchId

Идентификатор типа соответствия.
Этот параметр работает только для Яндекса. Для Google всегда пробивка идет с типом соответствия "extra".

"extra" учитывает и словоформу, и расположение.
Пример: "[!купить !слона !в !рассрочку]"

"exact": не учитывает порядок слов, но учитывает словоформу.
Пример: "!купить !слона !в !рассрочку"

"phrase": учитывает всё, что содержит эти слова в разном расположении и разные словоформы.
Пример: "купить слона в рассрочку”

"wide": широкое соответствие.
Пример: купить слона в рассрочку

"wide-fixed": широкое соответствие с фиксированной словоформой.
Пример: !купить !слона !в !рассрочку

string

Example PHP Python
Request data:

{
    "id": {{any_num_or_string}},
    "method": "SerpstatTaskProcedure.getTaskResult",
    "params": {
         "taskId": "665f297a-94c6-401c-9971-bed3025c1055",
         "page":1,
         "pageSize" : "10"
     }
}

Response data:

{
  "id": {{any_num_or_string}},
  "result": {
    "total": 6,
    "page": 1,
    "pageSize": 10,
    "keywords": [
      {
        "keyword": "iphone 10",
        "keyword.raw": "iphone 10",
        "status": 0,
        "cost": null,
        "searchVolume": null,
        "competition" : 1 // для google
      },
    ],
    "taskMeta": {
      "typeId": 1,
      "seId": 2,
      "regionId": 213,
      "match": "exact"
    }
  }
}

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

Войти Регистрация

Вы исчерпали лимит запросов.

Или email
Забыли пароль?
Или email
Optional
Back To Login

Не волнуйтесь! Напишите свой электронный адрес и мы пришлем вам новый пароль.

Вы уверены?

Awesome!

To complete your registration you need to enter your phone number

Назад

Мы отправили код подтверждения на ваш номер телефона

Your phone Resend code Осталось запросов

Что-то пошло не так.

Свяжитесь с нашей службой поддержки
Или подтвердите регистрацию с помощью Телеграм бота Перейдите по этой ссылке
Выберите один из проектов

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

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

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

Имя

Email

Телефон

Будем рады вашему комментарию
Увеличить лимиты

Улучшить тариф

Экспорт недоступен для вашего тарифного плана. Вам необходимо улучшить свой тариф до Lite или выше, чтобы получить доступ к инструменту Подробнее

Зарегистрироваться

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

Пригласить
Просмотр Редактирование

E-mail
Сообщение
необязательно
E-mail
Сообщение
необязательно

У вас закончились лимиты

Вы достигли лимита на количество созданных проектов и больше не можете создавать новые проекты. Увеличьте лимиты или удалите существующие проекты.

Я хочу больше лимитов
Открыть чат технической поддержки