Деякі функції обмежені.
Вхід Реєстрація

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

Відправка ключових фраз на Парсинг частотності 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"]

Said

Пошукова база

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.getTaskResultFreq. 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": []
    }
}