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

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

Звіти по ключовим словам

2.2.1. Ключові слова для фрази (keywords)

З 31.12.2021 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

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

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

Для пагінації необхідно використовувати параметри:
page_size: кількість результатів на сторінку (за замовчуванням 100, максимум 1000);
page: номер сторінки (за замовчуванням 1-а сторінка).

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

Параметр Опис Можливі значення
queries_from Мінімальна кількість запитів у місяць  0-100000000
queries_to Максимальна кількість запитів у місяць  0-100000000
cost_from Минимальна вартість за клік  0-200
cost_to Максимальна вартість за клік  0-200
concurrency_from Мінімальне значення конкуренції  1-100
concurrency_to Максимальне значення конкуренції

 1-100

right_spelling Фільтрація по фразам з неправильним написанням

not_contains - містить фрази з неправильним написанням;

contains - не містить фрази з неправильним написанням

Для сортування результату можливо використовувати параметри:
sort: поле по якому потрібно виконати сортування;
order: напрямок сортування (asc — за зростанням, desc — за спаданням).

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
total Кількість знайдених варіацій ключових фраз
hits Містить в собі відповідь
keyword Задана ключова фраза
cost Ціна за клік, $
concurrency Конкуренція ключової фрази в PPC (0-100%)
found_results Кількість знаденних результатів за ключовою фразою
region_queries_count Частотність ключової фрази у вибраному регіоні
types Перелік додаткових запитів, які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше)
geo_names Список топонімів в масиві, якщо топонім присутній у ключовій фразі. Якщо ні — масив пустий.
social_domains Соціальні домени, які знаходяться в топ-10 по заданій фразі
right_spelling Рекомендація щодо виправлення ключової фрази з орфографічною помилкою
lang Мова
keyword_length Кількість слів, розділених пробілом в ключовій фразі
difficulty Оцінка рівня конкуренції за ключовою фразою для просування в топ-10 (від 0 до 100%)
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків, що залишилися

Частина відповіді API, за яку знімається 1 ліміт:

{
    "keyword": "iphone 11",
    "keyword_id": "76373283",
    "cost": 0.7,
    "concurrency": 100,
    "found_results": 96,
    "region_queries_count": 2240000,
    "types": [
        "also_asks",
        "ads_top"
        ],
    "geo_names": [],
    "social_domains": [
        "wikipedia",
        "pinterest",
        "reddit",
        "amazon"
        ],
    "right_spelling": null,
    "lang": null,
    "keyword_length": 2,
    "difficulty": 30.39
},

2.2.2. Перегляд ключових слів (keyword_info)

З 31.12.2021 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

Метод keyword_info повертає дані по ключовому слову (кількість запитів, вартість за клік, рівень конкуренції та ін.). Аналогічний до звіту «Сумарний звіт» в Аналізі ключових слів.

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

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
keyword Задана ключова фраза
cost Ціна за клік, $
concurrency Конкуренція ключової фрази в PPC (0-100%)
found_results Кількість знаденних результатів за ключовою фразою
region_queries_count Частотність ключової фрази у вибраному регіоні
types Перелік додаткових запитів, які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше)
geo_names Список топонімів в масиві, якщо топонім присутній у ключовій фразі. Якщо ні — масив пустий.
social_domains Соціальні домени, які знаходяться в топ-10 по заданій фразі
right_spelling Рекомендація щодо виправлення для ключової фрази з орфографічною помилкою
lang Мова
difficulty Оцінка рівня конкуренції за ключовою фразою для просування в топ-10 (від 0 до 100%)
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків що залишилися

Ми списуємо 1 ліміт за 1 апит цього методу. Частина відповіді API, за яку знімається 1 ліміт:

{
    "result": {
        "keyword": "iphone",
        "keyword_id": "10300893",
        "cost": 1.8822413793103445,
        "concurrency": 100,
        "found_results": 79,
        "region_queries_count": 1220000,
        "types": [
            "shopping_top",
            "kn_graph_carousel_list",
            "also_asks"
        ],
        "geo_names": [],
        "social_domains": [
            "wikipedia",
            "amazon",
            "reddit"
        ],
        "right_spelling": null,
        "lang": null,
        "difficulty": 89.5890633703002,
        "suggestions_count": 2652668,
        "keywords_count": 8323766
    },

2.2.3. Пропозиції щодо пошуку ключових слів (suggestions)

З 31.12.2021 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

Метод suggestions виконує повнотекстовий пошук по пошуковим підказкам аналізованого ключового слова. Використовуйте параметр question = 1, щоб отримати лише запитання. Аналогічний до звіту Аналіз ключових слів — SEO-аналіз — Пошук підказок.

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

Для пагінації необхідно використовувати параметри:
page_size: кількість результатів на сторінку (за замовчуванням 100, максимум 1000);
page: номер сторінки (за замовчуванням 1-а сторінка).

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
total Кількість знайдених пошукових підказок
hits Містить в собі відповідь
keyword Пошукова підказка
geo_names Список топонімів в масиві, якщо топонім присутній у ключовій фразі. Якщо ні — масив пустий.
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків, що залишилися

Частина відповіді API, за яку знімається 1 ліміт:

{
    "keyword": "iphone x fre case release",
    "geo_names": [],
    "_id": "db44a9cbdacc966c4d6dc85f5f47f056"
},

2.2.4. Cхожі ключові слова (related_keywords)

З 31.12.2021 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

Метод related_keywords повертає пошукові запити, які пов'язані з аналізованою ключовою фразою семантично. Аналогічний до звіту Аналіз ключових слів — SEO-аналіз — Схожі фрази.

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

Для пагінації необхідно використовувати параметри:
page_size: кількість результатів на сторінку (за замовчуванням 100, максимум 1000);
page: номер сторінки (за замовчуванням 1-а сторінка).

Для сортування результату можливо використовувати параметри:
sort: поле по якому потрібно виконати сортування;
order: напрямок сортування (asc — за зростанням, desc — за спаданням).

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
total Кількість знайдених схожих фраз
hits Містить в собі відповідь
keyword Схожа фраза
region_queries_count Частотність ключової фрази у вибраному регіоні
cost Ціна за клік, $
concurrency Конкуренція ключової фрази в PPC (0-100%)
geo_names Список топонімів в масиві, якщо топонім присутній у ключовій фразі. Якщо ні — масив пустий.
types Перелік додаткових запитів, які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше)
right_spelling Рекомендація щодо виправлення для ключової фрази з орфографічною помилкою
weight Сила зв’язку схожих фраз
difficulty Оцінка рівня конкуренції за ключовою фразою для просування в топ-10 (від 0 до 100%)
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків, що залишилися

Частина відповіді API, за яку знімається 1 ліміт:

{
    "keyword": "when will next iphone come out",
    "region_queries_count": 2900,
    "cost": 6.75,
    "concurrency": 2,
    "geo_names": [],
    "types": [
        "also_asks",
        "snip_breadcrumbs"
        ],
    "weight": 1,
    "difficulty": 67
}

2.2.5. Toп для ключової фрази (keyword_top)

З 31.12.2021 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

Метод keyword_top повертає останній топ-100 Google або топ-50 Яндекс по ключовій фразі. Аналогічний до звіту Топ по фразі в Аналізі ключових слів.

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

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
top Містить результат
position Позиція домену за ключовою фразою в пошуковій видачі
url Сторінка, яка знаходиться на вказаній позиції
domain Домен, який ранжується за ключовою фразою
subdomain Піддомен сайту, який відображається в пошуковій видачі за заданною фразою
types Перелік додаткових запитів, які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше)
ads Містить результати контекстної реклами (якщо вона є)
results Кількість результатів
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків, що залишилися

Частина відповіді API, за яку знімається 1 ліміт:

{
    "position": 1,
    "url": "https://www.apple.com/iphone/",
    "domain": "apple.com",
    "subdomain": "www.apple.com",
    "types": [
        "shopping_top",
        "kn_graph_carousel_list",
        "also_asks",
        "snip_breadcrumbs"
        ]
},

2.2.6. Конкуренти (competitors)

З 31.12.2021 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

Метод competitors повертає конкурентів за заданою ключовою фразою з топ-20 пошукової видачі. Аналогічний до звіту Аналіз ключових слів — SEO-аналіз — Конкуренти.

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

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
"domain.com" Домен-конкурент, що містить в собі відповідь
domain Домен
visible Видимість сайту
keywords Кількість знайдених ключових фраз в заданій пошуковій системі
traff Індекс, який показує орієнтовний трафік на сайт (кількість відвідувачів)
visible_dynamic Динаміка зміни видимості в порівнянні з останньою датою оновлення
keywords_dynamic Зміна кількості ключових фраз в порівнянні з останньою датою оновлення
traff_dynamic Зміна трафіку в порівнянні з останньою датою оновлення
ads_dynamic Зміна кількості ключових фраз в контекстній рекламі
new_keywords Кількість нових ключових фраз, які з'явилися у домена в порівнянні з останньою датою оновлення
out_keywords Кількість ключових фраз, які втратив домен в порівнянні з останньою датою оновлення
rised_keywords Ключові фрази, у яких зросли позиції в порівнянні з останньою датою оновлення
down_keywords Ключові фрази, у яких впали позиції в порівнянні з останньою датою оновлення
ad_keywords Кількість ключових фраз в PPC
ads Кількість оголошень
intersected Кількість фраз у домену, які містять шукану фразу
relevance Загальна релевантність домену до шуканої фрази
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків що залишилися

 Частина відповіді API, за яку знімається 1 ліміт:

{
"apple.com": {
    "domain": "apple.com",
    "visible": 3417.2564,
    "keywords": 46650466,
    "traff": 1998603882,
    "visible_dynamic": 6.359480000000076,
    "keywords_dynamic": -751,
    "traff_dynamic": 7691041,
    "ads_dynamic": -390,
    "new_keywords": 153290,
    "out_keywords": 154041,
    "rised_keywords": 453556,
    "down_keywords": 465903,
    "ad_keywords": 5422,
    "ads": 4018,
    "visible_mysql": 0,
    "intersected": 829994,
    "relevance": 1.78,
    "our_relevance": 41.19
},

2.2.7. Рекламний звіт (ad_keywords)

З 31.12.2021 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

Метод ad_keywords виконує пошук ключових слів в платній видачі та рекламних оголошень по ключовому слову. Аналогічний до звіту Аналіз ключових слів — РРС-аналіз — Ключові слова.

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

Для пагінації необхідно використовувати параметри:
page_size: кількість результатів на сторінку (за замовчуванням 100, максимум 1000)
page: номер сторінки (за замовчуванням 1-а сторінка)

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

Параметр Опис Можливі значення
position_from Мінімальна позиція ключового слова  1-100
position_to Максимальна позиція ключового слова  1-100
queries_from Мінімальна кількість запитів у місяць  0-100000000
queries_to Максимальна кількість запитів у місяць  0-100000000
cost_from Минимальна вартість за клік  0-200
cost_to Максимальна вартість за клік  0-200
concurrency_from Мінімальне значення конкуренції  1-100
concurrency_to Максимальне значення конкуренції  1-100
url Фільтрація по url  string
keywords Фільтрація по словам (список слів через кому)  string
minus_keywords Фільтрація по мінус словам (список слів через кому)  string
exact_url Шукати тільки точне входження url  1 - активний
pm_url Шукати тільки часткове входження url  1 - активний


Для сортування результату можно використовувати параметри:
sort: поле по якому потрібно виконати сортування
order: напрямок сортування (asc — за зростанням, desc — за спаданням)

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
total Кількість знайдених ключових фраз в РРС за шуканою фразою
hits Містить в собі відповідь
keyword Ключова фраза, по якій відображається оголошення
keyword_length Кількість слів, розділених пробілом в ключовій фразі
domain Домен
subdomain Піддомен сайту, який відображається в пошуковій видачі
url URL оголошення, який відображається в пошуковій видачі за даним запитом
title Заголовок оголошення
text Текст оголошення
position Позиції оголошень контекстній рекламі
type Місце знаходження оголошення в SERP (1 - над; 2 - під; 3 - справа)
cost Ціна за клік, $
concurrency Конкурентність в контекстній рекламі (0-100%)
found_results Кількість знаденних результатів за ключовою фразою
region_queries_count Частотність ключової фрази у вибраному регіоні
region_queries_count_last Частотність ключової фрази за останній місяць
types Перелік додаткових запитів, які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше)
geo_names Список топонімів в масиві, якщо топонім присутній у ключовій фразі. Якщо ні — масив пустий.
difficulty
Оцінка рівня конкуренції за ключовою фразою для просування в топ-10 (від 0 до 100%)
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків, що залишилися

Частина відповіді API, за яку знімається 1 ліміт:

{
    "keyword": "iphone see",
    "keyword_id": 50423945,
    "keyword_length": 2,
    "domain": "apple.com",
    "subdomain": "www.apple.com",
    "url": "https://www.apple.com/iphone-se/",
    "url_crc": 818000116,
    "title": "iPhone SE - Apple Official Site",
    "text": "The A13 Bionic chip is built for speed. It’s just what you’ve been waiting for.",
    "crc": -1550457144,
    "position": 1,
    "type": "1",
    "cost": 1.54,
    "concurrency": 100,
    "found_results": 2920000000,
    "region_queries_count": 1500000,
    "region_queries_count_last": 1830000,
    "types": [
        "top_stories",
        "also_asks",
        "kn_graph_carousel_list",
        "shopping_top",
        "ads_top"
        ],
    "geo_names": [],
    "difficulty": 73.432686121561062,
    "modified_date": "2021-07-14",
    "_id": "50423945_1"
},

2.2.8. Найпопулярніші фрази (top_words)

З 31.12.2021 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

Метод top_words призначений для пошуку популярних слів при побудові пошукових підказок. Аналогічна інформація з найпопулярнішими фразами у звіті Пошук підказок Аналізу ключових слів.

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

Для пагінації необхідно використовувати параметри:
page_size: кількість результатів на сторінку (за замовчуванням 100, максимум 1000)
page: номер сторінки (за замовчуванням 1-а сторінка)

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
total Кількість знайдених пошукових підказок
hits Масив знайдених топ слів для шуканої фрази
keyword Популярне слово для шуканої фрази
count
В скількох фразах зустрічається популярне слово
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків, що залишилися

Частина відповіді API, за яку знімається 1 ліміт:

{
    "keyword": "app",
    "count": 32
},

2.2.9. Ключові слова для фрази V4 (SerpstatKeywordProcedure.getKeywords)

Метод 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_from": 0.1}

{"right_spelling": 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

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

Параметр Опис Можливі значення 
queries_from Мінімальна частотність в місяць  0-100000000
queries_to Максимальна частотність в місяць  0-100000000
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
},

2.2.10. Дані за ключовим словом V4 (SerpstatKeywordProcedure.getKeywordsInfo)

Метод SerpstatKeywordProcedure.getKeywordsInfo повертає дані по ключовому слову (кількість запитів, вартість за клік, рівень конкуренції та ін.). Аналогічний до звіту «Сумарний звіт» в Аналізі ключових слів.

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

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

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

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

field — поле, за яким потрібно виконати сортування (всі числові значення, орім suggestions_count и keywords_count)

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

array так [ ] 
порожній масив

{"cost": "desc"}

{"right_spelling": true}

Параметри відповіді
Параметр Опис
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 Мова
difficulty Рівень конкуренції за ключовою фразою для просування в топ-10 органічної видачі
suggestions_count Кількість пошукових підказок
keywords_count Кількість ключових фраз
summary_info Об'єкт з даними відповіді
page Номер сторінки
left_lines Кількість API рядків, що залишилися

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

{
    "keyword": "iphone",
    "cost": 1.8822413793103445,
    "concurrency": 100,
    "found_results": 79,
    "region_queries_count": 1220000,
    "region_queries_count_wide": 0,
    "region_queries_count_phrase": 0,
    "types": [
        "shopping_top",
        "kn_graph_carousel_list",
        "also_asks"
        ],
    "geo_names": [],
    "social_domains": [
        "wikipedia",
        "amazon",
        "reddit"
        ],
    "right_spelling": null,
    "lang": null,
    "difficulty": 89.5890633703002,
    "suggestions_count": 2652668,
    "keywords_count": 8323766
},

2.2.11. Пошукові підказки за ключовою фразою V4 (SerpstatKeywordProcedure.getSuggestions)

Метод SerpstatKeywordProcedure.getSuggestions виконує повнотекстовий пошук по пошуковим підказкам аналізованого ключового слова. Аналогічний до звіту Аналіз ключових слів — SEO-аналіз — Пошук підказок.

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

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

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

min: 1, max: 1000

Параметри відповіді
Параметр Опис
id Ідентифікатор відповіді: відповідає id в запиті
result Містить в собі відповідь
data Масив з даними
keyword Задана ключова фраза
geo_names Список топонімів в масиві, якщо топонім присутній в ключовій фразі. Якщо немає - масив порожній.
summary_info Об'єкт з даними відповіді
page Номер сторінки
total Кількість знайдених пошукових підказок
left_lines Кількість API рядків, що залишилися

Частина відповіді API, за яку знімається 1 ліміт:

{
    "keyword": "iphone x fre case release",
    "geo_names": []
},

2.2.12. Схожі ключові фрази V4 (SerpstatKeywordProcedure.getRelatedKeywords)

Метод SerpstatKeywordProcedure.getRelatedKeywords повертає пошукові запити, які пов'язані з аналізованою ключовою фразою семантично. Аналогічний до звіту Аналіз ключових слів — SEO-аналіз — Схожі фрази.

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

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

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

Сила зв'язку схожих фраз
{"Weight": {{weight_from}}

{"right_spelling": true}

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

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

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

{ cost: {{"asc"|"desc"}}}

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

min: 1, max: 1000

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

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

"11 pro price iphone": {
    "keyword": "11 pro price iphone",
    "region_queries_count": 70,
    "cost": 0,
    "concurrency": 0,
    "geo_names": [],
    "types": [
        "related_search",
        "top_stories",
        "shopping_top",
        "also_asks",
        "kn_graph_carousel_list",
        "snip_breadcrumbs"
        ],
    "right_spelling": null,
    "weight": 1,
    "difficulty": 85.95114002363806
},

2.2.13. Топ за ключовою фразою V4 (SerpstatKeywordProcedure.getKeywordTop)

Метод SerpstatKeywordProcedure.getKeywordTop повертає останній топ-100 Google або топ-50 Яндекс по ключовій фразі. Аналогічний до звіту Топ по фразі в Аналізі ключових слів.

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

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

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

{"top_size": 100}

top_size цифрове значення від 1 до 100

Параметри відповіді
Параметр Опис
id Ідентифікатор відповіді: відповідає id в запиті
result Містить в собі відповідь
data Масив з даними
top Містить в собі відповідь
position Позиція домену за ключовою фразою в пошуковій видачі
url Сторінка, яка знаходиться на вказаній позиції
domain Домен, який ранжується за ключовою фразою
subdomain Піддомен сайту, який відображається в пошуковій видачі за заданною фразою
types Список додаткових елементів які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше)
ads Містить результати контекстної реклами (якщо вона є)
results Кількість результатів
summary_info Об'єкт з даними відповіді
page Номер сторінки
left_lines Кількість API рядків, що залишилися

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

{
    "position": 1,
    "url": "https://www.apple.com/iphone/",
    "domain": "apple.com",
    "subdomain": "www.apple.com",
    "types": [
        "shopping_top",
        "kn_graph_carousel_list",
        "also_asks",
        "snip_breadcrumbs"
        ]
},

2.2.14. Конкуренти за ключовими словами V4 (SerpstatKeywordProcedure.getCompetitors)

Метод SerpstatKeywordProcedure.getCompetitors повертає конкурентів за заданою ключовою фразою з топ-20 пошукової видачі. Аналогічний до звіту Аналіз ключових слів — SEO-аналіз — Конкуренти.

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

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

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

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

field — поле, за яким потрібно виконати сортування:
* visible
* keywords
* traff
* visible_dynamic
* keywords_dynamic
* traff_dynamic
* ads_dynamic
* new_keywords
* out_keywords
* rised_keywords
* down_keywords
* ad_keywords
* ads
* intersected
* relevance
* our_relevance

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

array так [ ] 
порожній масив

{"keyword": "desc"} 

або

{"visible": "asc"}

size Кількість результатів на сторінку у відповіді int так 100 "size": "10"

min: 1, max: 1000

Параметри відповіді

Параметр

Опис

id

Ідентифікатор відповіді: відповідає id в запиті

result

Містить в собі відповідь

data

Масив з даними

domain

Домен

visible

Видимість сайту

keywords

Кількість знайдених ключових фраз в обраній пошуковій системі

traff

Індекс, який показує орієнтовний трафік на сайт (кількість відвідувачів)

visible_dynamic

Динаміка зміни видимості в порівнянні з останньою датою оновлення

keywords_dynamic

Зміна кількості ключових фраз в порівнянні з останньою датою оновлення

traff_dynamic

Зміна трафіку в порівнянні з останньою датою оновлення

ads_dynamic

Зміна кількості ключових фраз в контекстній рекламі

new_keywords

Кількість нових ключових фраз, які з'явилися у домену в порівнянні з останньою датою оновлення

out_keywords

Кількість ключових фраз, які втратив домен в порівнянні з останньою датою оновлення

rised_keywords

Ключові фрази, за якими зросли позиції в порівнянні з останньою датою оновлення

down_keywords

Ключові фрази, за якими впали позиції в порівнянні з останньою датою оновлення

ad_keywords

Кількість ключових фраз в PPC

ads

Кількість оголошень

intersected

Кількість фраз у домену, які містять шукану фразу

relevance

Загальна релевантність домену до шуканої фрази

summary_info Об'єкт з даними відповіді
page Номер сторінки

left_lines

Кількість API рядків, що залишилися

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

{
"apple.com": {
    "domain": "apple.com",
    "visible": 3417.2564,
    "keywords": 46650466,
    "traff": 1998603882,
    "visible_dynamic": 6.359480000000076,
    "keywords_dynamic": -751,
    "traff_dynamic": 7691041,
    "ads_dynamic": -390,
    "new_keywords": 153290,
    "out_keywords": 154041,
    "rised_keywords": 453556,
    "down_keywords": 465903,
    "ad_keywords": 5422,
    "ads": 4018,
    "intersected": 829984,
    "relevance": 1.78,
    "our_relevance": 9.97
},

2.2.15. Рекламні оголошення за ключовою фразою V4 (SerpstatKeywordProcedure.getAdKeywords)

Метод SerpstatKeywordProcedure.getAdKeywords виконує пошук ключових слів в платній видачі та рекламних оголошень по ключовому слову. Аналогічний до звіту Аналіз ключових слів — РРС-аналіз — Ключові слова.

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

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

Параметри запиту

Параметр

Опис

Тип

Опціональність

Значення за замовчуванням

Варіанти значень

id

Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення

int/string

ні

1, test

method

Назва методу API

string

ні

SerpstatKeywordProcedure.getAdKeywords

params

Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]

array

ні

keyword

Фраза, для якої буде відбуватися пошук

string

ні

iphone

se

Ідентифікатор пошукової бази, по якій буде проходити пошук (доступні бази Google і Yandex на вибір, наприклад: g_us, y_157).

string

ні

g_us

domains

Список доменів

array

так

[]

["apple.com","verizon.com"]

minusKeywords

Масив мінус-слів при пошуку

array

так

[]

["app", "apple"]

filters

Умови фільтрації

json object

так

 

{"queries_from": 10} {"queries_to": 10}

sort

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

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

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

json object

так

{"position": "asc", "region_queries_count":"desc"}

{"cost": "asc"}

page

Номер сторінки у відповіді

int

так

1

"page": "5"

size

Кількість результатів на сторінку у відповіді

int

так

100

"size": "10"

min: 1, max: 1000

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

Параметр Опис Можливі значення 
position_from Мінімальна позиція ключового слова  1-100
position_to Максимальна позиція ключового слова  1-100
queries_from Мінімальна кількість запитів на місяць  0-100000000
queries_to Максимальна кількість запитів на місяць  0-100000000
cost_from Мінімальна вартість за клік  0-200
cost_to Максимальна вартість за клік  0-200
concurrency_from Мінімальне значення конкуренції  0-100
concurrency_to Максимальне значення конкуренції  0-100
results_from Мінімальне значення результатів 0-100000000
results_to Максимальне значення результатів 0-100000000
length_from Мінімальне значення довжини фрази 0-100000000
length_to Максимальне значення довжини фрази 0-100000000

Параметри відповіді

Параметр

Опис

id

Ідентифікатор відповіді: відповідає id в запиті

result

Містить в собі відповідь

data Масив з даними
keyword Ключова фраза, за якою відображається оголошення
keyword_length Кількість слів, розділених пробілом в ключовій фразі

domain

Домен 

subdomain Піддомен сайту, який відображається в пошуковій видачі
url URL оголошення, який відображається в пошуковій видачі за даним запитом

title

Заголовок оголошення

text

Текст оголошення

position

Позиції оголошень контекстній рекламі

type

Місце знаходження оголошення в SERP (1 - над; 2 - під; 3 - справа)

cost

Ціна за клік, $

concurrency

Конкурентність в контекстній рекламі (0-100%)

found_results

Кількість знаденних результатів за ключовою фразою

region_queries_count

Частотність ключової фрази у вибраному регіоні

region_queries_count_wide

Частотність ключової фрази у широкій відповідності

types

Перелік додаткових запитів, які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше)

geo_names

Список топонімів в масиві, якщо топонім присутній у ключовій фразі. Якщо ні — масив пустий

difficulty

Оцінка рівня конкуренції за ключовою фразою для просування в топ-10 (від 0 до 100%)

summary_info

Об'єкт з даними відповіді

page

Номер сторінки

total

Кількість знайдених ключових фраз в РРС за шуканою фразою

left_lines

Кількість API-рядків, що залишилися

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

{
    "keyword": "upgrade iphone x to xs",
    "keyword_length": 5,
    "domain": "apple.com",
    "subdomain": "www.apple.com",
    "url": "https://www.apple.com/iphone/",
    "title": "Trade in for iPhone 12 - Apple Official Site",
    "text": "Get $90 - $515 off iPhone 12 when you trade in an iPhone 7 or newer. Terms apply. A14 Bionic Chip. 5G speed. Ceramic Shield. Super Retina XDR display. Services: Free no-contact delivery, Finance with Apple Card, 3% cash back w/Apple Card, Prepaid mail-in kit.",
    "position": 2,
    "type": "1",
    "cost": 0,
    "concurrency": 50,
    "found_results": 325000000,
    "region_queries_count": 10,
    "region_queries_count_wide": 0,
    "types": [
        "carousel",
        "also_asks",
        "video",
        "ads_top"
        ],
    "geo_names": [],
    "difficulty": null
},

2.2.20. Список конкурентів за ключовою фразою в РРС V4 (SerpstatKeywordProcedure.getAdsCompetitors)

Метод SerpstatKeywordProcedure.getAdsCompetitors виконує пошук доменів-конкурентів в РРС за ключовою фразою. Аналогічний до звіту «Конкуренти» у РРС-аналізі за ключовою фразою.

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

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

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

min: 100, max: 1000
sort

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

field - поле, по якому потрібно виконати сортування:
ads
all
common

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

json object так {"common": "desc"}

Параметры відповіді
Параметр Опис
id Ідентифікатор відповіді: відповідає id в запиті
result Містить в собі відповідь
data Масив з даними
domain Домен-конкурент
ads Кількість оголошень для домену
all Кількість ключових фраз для домену у РРС
common Спiльнi ключові фрази у РРС
summary_info Об'єкт з даними відповіді
page Номер сторінки
left_lines Кількість API-рядків, що залишилися

Ліміти: кількість списаних лімітів відповідає кількості отриманих результатів за запитом. Частина відповіді API, за яку знімається 1 ліміт:

{
    "domain": "verizon.com",
    "ads": 8953,
    "all": 30855,
    "common": 1437
},