Деякі функції обмежені. Зареєструйтесь безкоштовно
Switch to english interface?

Пiдбiр ключових фраз

Метод SerpstatKeywordProcedure.getKeywords метод представляє всі варіаціі аналізованої ключової фрази, за якою домени ранжуються в топ-100 органічної видачі Google або топ-50 Яндекс, і надає дані за знайденими ключовими словами (кількість запитів, вартість за клік, рівень конкуренції та ін.). Аналогічний до звіту Аналіз ключових слів — SEO-аналіз — Підбір ключових фраз.

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

Доступні пошукові бази

Параметри запиту
Назва Опис Тип даних Опціональний Значення за замовчуванням Варіанти значень
id Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення int/string ні 1, test
method Назва методу API string ні SerpstatKeywordProcedure.getKeywords
params Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...] array ні
keyword Фраза, для якої буде відбуватися пошук string ні   iphone
se Ідентифікатор пошукової бази, по якій буде проходити пошук (доступні бази Google і Yandex на вибір, наприклад: g_us, y_157). string ні   g_us
minusKeywords Список мінус-слів при пошуку array так [ ] порожній масив  ["app", "apple"]
filters Умови фільтраціі array так

"cost": "10";
"cost_to": "10";
"cost_from": 1

"region_queries_count": "1000";
"region_queries_count_to": "2000";
"region_queries_count_from": 300

keyword_length : num
keyword_length_from : num
keyword_length_to : num

"difficulty": 3;
"difficulty_from": 5;
"difficulty_to": 10

"concurrency": "7";
"concurrency_to": "7";
"concurrency_from": 1

"right_spelling": true, "right_spelling": false

"misspelled": true, "misspelled": false

sort

Порядок сортування результатів в форматі: {{{Field}}: {{order}}}

field — поле, за яким потрібно виконати сортування:
* cost
* concurrency
* found_results
* region_queries_count
* region_queries_count_wide
* keyword_length


order — напрямок сортування (asc — за зростанням, desc — за спаданням)

array так ['cost' => 'asc', 'region_queries_count' => 'desc']

{"keyword": "desc"} 

или

['cost' => 'asc', 'region_queries_count' => 'desc']

page Номер сторінки у відповіді int так 1 "page": "5"
size Кількість результатів на сторінку у відповіді int так 100 "size": "10"

min: 1, max: 1000

Для фільтрації результатів використовуйте наступні параметри:

Параметр Опис Можливі значення 
cost_from Мінімальна вартість за клік  0-200
cost_to Максимальна вартість за клік  0-200
concurrency_from Мінімальне значення конкуренції ключової фрази в PPC  0-100
concurrency_to Максимальне значення конкуренції ключової фрази в PPC  0-100
minus_keywords  Фільтрація за мінус-словами (список слів через кому)  string

Параметри відповіді
Параметр Опис
id Ідентифікатор відповіді: відповідає id в запиті
result Містить в собі відповідь
data Масив з даними
keyword Ключова фраза
cost Ціна за клік, $
concurrency Конкуренція ключевої фрази в PPC (0-100%)
found_results Кількість знайдених результатів за ключовою фразою
region_queries_count Частотність ключової фрази в обраном регіоні
region_queries_count_wide Частотність ключової фрази в широкій відповідності
types Список додаткових елементів які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше).
geo_names Список топонімів в масиві, якщо топонім присутній в ключовій фразі. Якщо немає - масив порожній.
social_domains Соціальні домени, які знаходяться в топ-10 за вашим запитом
right_spelling Рекомендація до виправлення для ключової фрази з орфографічною помилкою
lang Мова
keyword_length Кількість слів, розділених пробілом в ключовій фразі
difficulty Оцінка рівня конкуренції за ключовою фразою для просування в топ-10 (від 0 до 100%)
summary_info Об'єкт з даними відповіді
page Номер сторінки
total Кількість знайдених варіацій ключових фраз
left_lines Кількість API рядків, що залишилися

Ліміти: кількість списаних лімітів відповідає кількості отриманих ключових фраз у відповіді. За один запит можна отримати не більше 60000 результатів. Частина відповіді API, за яку знімається 1 ліміт:

{
    "keyword": "how to download you tube videos on iphone",
    "cost": 0.56999999999999995,
    "concurrency": 1,
    "found_results": 729000000,
    "region_queries_count": 9900,
    "region_queries_count_wide": 0,
    "types": [
        "a_box_fsnippet",
        "local_related_search",
        "related_search"
        ],
    "geo_names": [],
    "social_domains": [
        "youtube",
        "reddit"
        ],
    "right_spelling": "how to download youtube videos on iphone",
    "lang": null,
    "keyword_length": 8,
    "difficulty": 17.57
},

Example PHP Python
Request data:
{
 "id": "1",
 "method": "SerpstatKeywordProcedure.getKeywords",
 "params": {
   "keyword": "iphone",
   "se": "g_us",
   "minusKeywords": ["app", "apple"],
   "sort": {"region_queries_count": "desc"},
   "page": "1",
   "size": "10"
 }
}
Response data:
{
                "keyword": "iphone 13",
                "cost": 1.8600000000000001,
                "concurrency": 100,
                "found_results": 3420000000,
                "region_queries_count": 3350000,
                "region_queries_count_wide": 0,
                "types": [
                    "also_asks",
                    "top_stories"
                ],
                "geo_names": [],
                "social_domains": [
                    "wikipedia",
                    "twitter",
                    "amazon"
                ],
                "right_spelling": null,
                "lang": null,
                "keyword_length": 2,
                "difficulty": 46.481060722595139,
                "also_asks": [
                    "what will be the cost of iphone 13",
                    "will there be an iphone 13 mini",
                    "is there an iphone 13 coming out"
                ]
            },
}

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

Ви впевнені?

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

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

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

Ім’я

Email

Телефон

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

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

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

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