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

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

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

SerpstatTaskProcedure.addKeywordListFreq метод отправляет ключевые фразы на парсинг частотности и возвращает уникальный ключ задачи, который нужно будет использовать в методе SerpstatTaskProcedure.getTaskResultFreq для получения результатов парсинга. Ключевые фразы нужно передавать в виде массива. Если в ответе: “data [ “ — это массив и так же должно быть написано и в параметрах запроса и ответа.


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

Название параметра Описание Тип данных Опциональный Значение по умолчанию Варианты значений
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 идентификатор запроса который служит для обработки асинхронных запросов. Соответствует значению в запросе. int
result Инкапсулирует в себе ответ array
taskId идентификатор запроса, по которому в дальнейшем можно будет получить результат парсинга в методе SerpstatTaskProcedure.getTaskResultFreq. string
accepted суммарное количество ключевых фраз, которые поставлены на парсинг, без учета blocked. int
blocked массив с заблокированными ключевыми фразами. Лимиты за них списаны не будут. array

Блокировка ключевых фраз

Для некоторых ключевых фраз проверка частотности проходить не будет и они попадут в массив blocked в ответе метода. В blocked попадут фразы, которые содержат поисковые операторы:

  • site:
  • related:
  • info:
  • cache:
  • OR 
  • url:
  • inurl:

Дополнительно для Yandex:

  • title:
  • rhost:
  • host:
  • domain:
  • mime:
  • lang:
  • date:
  • cat:

Чистка ключевых фраз от спецсимволов

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

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

Блокировка проверки частотности на уровне поисковой системы

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

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

Лимиты:

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

Example Python
Request data:

{
    "id": 1,
    "method": "SerpstatTaskProcedure.addKeywordListFreq",
    "params": {
         "keywords": ["iphone", "iphone X", "iphone 10", "iphone 11", "iphone 12", "iphone 13"],
         "seId": 1,
         "typeId": 1,
         "regionId": 2804,
         "match":"exact"
     }
}

Response data:

{
    "id": "1",
    "result": {
        "taskId": "a6147573-a4b2-434b-ad19-60ce6031bdde",
        "accepted": 6,
        "duplicates_cleaned": 0,
        "blocked": []
    }
}