Некоторые функции ограничены. Зарегистрируйтесь бесплатно

Отправка ключевых фраз на Парсинг Частотности V4 (SerpstatTaskProcedure.addKeywordListFreq)

Метод SerpstatTaskProcedure.addKeywordListFreq отправляет ключевые фразы на парсинг частотности и возвращает уникальный ключ задачи, который нужно будет использовать в методе SerpstatTaskProcedure.getTaskResult для получения результатов парсинга. Ключевые фразы нужно передавать в виде массива.

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

Параметры запроса
Параметр Описание Тип данных Опциональный Значение по умолчанию Варианты значений
id Идентификатор текущего запроса string нет 1, test
method Имя метода string нет SerpstatTaskProcedure.addKeywordListFreq
params Объект с параметрами object нет
keywords Ключевые слова (максимальное количество - 50 000) array нет - 
["iphone", "iphone X"]
seId Поисковая база string да 1 1 - google
2 - yandex
typeId Идентификатор типа устройства int да 1 1 - desktop
2 - mobile
regionId Идентификатор региона или города для Google и Yandex. Соответствие региону указано в документе. int нет    
match Идентификатор типа соответствия (только для Яндекса) string да exact

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

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

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

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

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

Параметры ответа
Параметр Описание Тип данных
id Идентификатор запроса: соответствует id в запросе int
result Содержит в себе ответ array
taskId Идентификатор запроса, по которому в дальнейшем можно будет получить результат парсинга в методе SerpstatTaskProcedure.getTaskResult. string
accepted Суммарное количество ключевых фраз, которые поставлены на парсинг, без учета blocked. int
duplicates_cleaned
Количество дублей ключевых фраз, которые были очищены, лимиты за них не будут списываться. int
blocked Массив с заблокированными ключевыми фразами. Лимиты за них списаны не будут. array

Блокировка ключевых фраз
Для некоторых ключевых фраз проверка частотности проходить не будет, и они попадут в массив «blocked» в ответе метода.
В «blocked»
 попадут фразы, которые содержат поисковые операторы:
- site:
- related:
- info:
- cache:
- OR 
- url:
- inurl:

Дополнительно для Yandex:
- title:
- rhost:
- host:
- domain:
- mime:
- lang:
- date:
- cat:

Чистка ключевых фраз от спецсимволов
Из всех не попавших в blocked ключевых фраз удаляются спецсимволы.

Список запрещенных спецсимволов:
*
+
@
~
!
&
|
(
)
:
.
;

Блокировка проверки частотности на уровне поисковой системы
Ключевая фраза может не пройти проверку на уровне поисковой системы. Тематики ключевиков, которые не пройдут проверку:
- в Google
- в Яндекс

Если ключевая фраза не проходит проверку на уровне поисковой системы, то в ответе метода SerpstatTaskProcedure.getTaskResult для ключевой фразы в поле status будет значение — 4.

Лимиты:
На данный метод распространяются отдельные лимиты, с условиями и стоимостью вы можете ознакомиться по ссылке.

Example
Request data:
{
"id": "1" ,
"method": "SerpstatTaskProcedure.addKeywordListFreq",
"params": { 
    "keywords": ["iphone", "iphone X", "iphone 10", "iphone 11", "iphone 12", "iphone 13"],
    "typeId": 1, 
    "seId": 1,
    "regionId": 2840
     }
}
Response data:
{
    "id": "1",
    "result": {
        "taskId": "bc0a46cc-357e-4706-a674-1e8166f81fb2",
        "accepted": 6,
        "duplicates_cleaned": 0,
        "blocked": []
    }
}

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

Вы уверены?

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

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

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

Имя

Email

Телефон

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

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

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

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