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

Метод 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": []
    }
}