Switch to english interface?

Отправить ключевые фразы на парсинг

Метод 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
typeId Идентификатор типа устройства int да 1 1 - desktop
regionId Идентификатор региона или города для Google. Соответствие региону указано в документе. int нет    

Параметры ответа
Параметр Описание Тип данных
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:

Чистка ключевых фраз от спецсимволов
Из всех не попавших в 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

Телефон

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

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

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