Switch to english interface?

Визначення завдання для отримання звичайної та локальної видачі за ключовими фразами, що містять коми

Метод tasks.addKeywordList дозволяє визначити завдання для отримання звичайної та локальної видачі за ключовими фразами, що містять коми.

Загальні параметри запиту та інструкція щодо використання Serpstat API

Параметри запиту для звичайної видачі
Параметр Опис Тип даних Опціональний Значення за замовчуванням Варіанти значень
id Ідентифікатор поточного запиту, можна вказати вручну чи визначити автоматично string ні 1, test
method Ім'я методу string ні   tasks.addKeywordList
params Об'єкт з параметрами object ні
keywords Ключові фрази, за якими буде проходити зняття видачі array ні
["samsung, iphone", "nike, adidas"]
seId

Ідентифікатор пошукової системи

int ні 1 — Google
countryId Ідентифікатор країни
Відповідність країні (за Google) зазначено в документі
int ні 23 (USA)
regionId

Ідентифікатор регіону чи міста.
Відповідність регіону зазначено в документі

int так  Google 21176 (Texas)
langId

Ідентифікатор мови.
Відповідність мові зазначено в документі.

int ні 1 (англійська)
typeId

Тип пристрою

int так Desktop 1 — Desktop
2 — Mobile


Локальна (local) видача

У видачі Google в блоці Local pack при відкритті всіх результатів показується місцева (local) видача з картою, де відображаються блоки з інформацією щодо бізнесу/громадські місця. Щоб отримати ці дані (max 50 результатів), у запиті необхідно додати наступний параметр:

type

Тип видачі

string так За замовчуванням значення "regular" — звичайна видача; "local" — для місцевих результатів local

Приклад запиту для Local видачі:
{
    "id": "some_id" ,
    "method": "tasks.addKeywordList",
    "params": {
         "keywords": ["samsung, iphone", "nike, adidas"],
         "typeId": 1,
         "seId": 1,
         "countryId":  23,
         "langId": 1,
         "type": "local"
     }
}

Параметри відповіді
Параметр Опис
id Відповідно до ідентифікатора запиту
result Містить в собі відповідь
task_id
Ідентифікатор задачі для отримання результату
blocked_keywords Ключові фрази зі спецсимволами, що не були враховані, ліміти за них не знімають

Можливі помилки
Значення Опис
You have no keywords after filtrating, blocked keywords: [список заблокованих ключів] Немає валідних (відповідних до правил) ключових фраз
Required parameter '[параметр]' missed Немає обов’язкового параметру
Task (id=x) with such parameters has already been created today Завдання з такими параметрами сьогодні створювали
No such se_id Невалідний ідентифікатор пошукової системи (se_id)
device_type_id
Invalid type id value
Невалідний тип пристрою (type_id)

Example
Request data:
{
    "id": "some_id" ,
    "method": "tasks.addKeywordList",
    "params": {
         "keywords": ["samsung, iphone", "nike, adidas"],
         "typeId": 1,
         "seId": 1,
         "countryId":  23,
         "langId": 1
     }
}
Response data:
{
    "id": "some_id",
    "result": {
        "task_id": "2071492",
        "blocked_keywords": []
    }
}

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

Ви впевнені?

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

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

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

Ім’я

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

Телефон

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

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

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