Switch to english interface?

Відправити ключов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": []
    }
}

Поділіться статтею з вашими друзями

Ви впевнені?

Знайомство з сервісом

Serpstat економить час, як і ми готові заощадити ваш, на знайомстві з ключовими можливостями сервісу.

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

Ім’я

Введіть адресу електронної пошти

Телефон

Будемо раді вашому коментарю

Дякуємо, ми зберегли ваші нові налаштування розсилок.

Відкрити чат технічної підтримки