Відправити ключовi фрази на парсинг

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