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

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

Метод 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)

Метод 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)

Метод 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)

Метод 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)

Метод 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)

Метод 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)

Метод 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)

Метод 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	Ідентифікатор пошукової бази, по якій буде проходити пошук	string	ні		g_us
minusKeywords	Список мінус-слів при пошуку	array	так	[ ] порожній масив	["app", "apple"]
filters	Умови фільтраціі	array	так		{"cost_from": 0.1}
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	Ідентифікатор пошукової бази, по якій буде проходити пошук	string	ні		g_us
filters	Порядок сортування результатів в форматі: {{{Field}}: {{order}}} field — поле, за яким потрібно виконати сортування (всі числові значення, орім suggestions_count и keywords_count) order — напрямок сортування (asc — за зростанням, desc — за спаданням)	array	так	[ ] порожній масив	{"cost": "desc"}

Параметри відповіді
Параметр	Опис
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 рядків, що залишилися

{
    "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	Ідентифікатор пошукової бази, по якій буде проходити пошук	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	Ідентифікатор пошукової бази, по якій буде проходити пошук	string	ні		g_us
filters	Умови фільтраціі	array	так		Сила зв'язку схожих фраз {"Weight": {{weight_from}}
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	Ідентифікатор пошукової бази, по якій буде проходити пошук	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 рядків, що залишилися

{
    "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	Ідентифікатор пошукової бази, по якій буде проходити пошук	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 рядків, що залишилися

{
"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	Ідентифікатор пошукової бази, по якій буде проходити пошук	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	Ідентифікатор пошукової бази, для якої буде проходити пошук	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
},