Аналiз ключових слiв
3.1. Сумарний звiт
Метод 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 | |
sort |
Порядок сортування результатів в форматі: {{{Field}}: {{order}}} |
array | так | [ ] порожній масив |
{"cost": "desc"} |
filters |
Умови фільтраціі |
array | так |
"right_spelling": true$ "right_spelling": false "minus_keywords": ["case", "red"] "cost": "10"; "concurrency": "7"; "found_results": "100"; "region_queries_count": "1000"; "region_queries_count_wide": "1000"; |
Параметри відповіді | |
Параметр | Опис |
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
},
3.2. П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"; "region_queries_count": "1000"; keyword_length : num "difficulty": 3; "concurrency": "7"; "right_spelling": true, "right_spelling": false "misspelled": true, "misspelled": false |
|
sort |
Порядок сортування результатів в форматі: {{{Field}}: {{order}}} |
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
},
3.3. Пошукові підказки
Метод 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 |
filters | Умови фільтраціі | array | так | "minus_keywords": ["case", "red"] |
Параметри відповіді | |
Параметр | Опис |
id | Ідентифікатор відповіді: відповідає id в запиті |
result | Містить в собі відповідь |
data | Масив з даними |
keyword | Задана ключова фраза |
geo_names | Список топонімів в масиві, якщо топонім присутній в ключовій фразі. Якщо немає - масив порожній. |
summary_info | Об'єкт з даними відповіді |
page | Номер сторінки |
total | Кількість знайдених пошукових підказок |
left_lines | Кількість API рядків, що залишилися |
Частина відповіді API, за яку знімається 1 ліміт:
{
"keyword": "iphone x fre case release",
"geo_names": []
},
3.4. Схожі ключові фрази
Метод SerpstatKeywordProcedure.getRelatedKeywords повертає пошукові запити, які пов'язані з аналізованою ключовою фразою семантично. Аналогічний до звіту Аналіз ключових слів / Схожі фрази.
Загальні параметри запиту та інструкція щодо використання 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 | так |
Сила зв'язку схожих фраз: Фрази з неправильним написанням: Частотнiсть: |
|
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 ліміт:
"data": {
"6 plus portrait dimensions": {
"keyword": "6 plus portrait dimensions",
"region_queries_count": 1,
"cost": 0,
"concurrency": 0,
"geo_names": [],
"types": [
"also_asks",
"video",
"related_search",
"snip_breadcrumbs"
],
"right_spelling": null,
"weight": 1,
"difficulty": null
}
3.5. Топ за ключовою фразою
Метод 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 "position": 1 "url": https://www.apple.com/iphone/ "exact_url": https://www.apple.com/iphone-13-pro/ "domain": www.apple.com "minus_domain": www.blackberry.com "subdomain": developer.apple.com |
Параметри відповіді | |
Параметр | Опис |
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"
]
},
3.6. Конкуренти в пошуковій видачі
Метод 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}}} |
array | так | [ ] порожній масив |
{"keyword": "desc"} або {"visible": "asc"} |
size | Кількість результатів на сторінку у відповіді | int | так | 100 | "size": "10" min: 1, max: 1000 |
filters | Умови фільтраціі | array | так |
"domain": www.apple.com "minus_domain": www.blackberry.com "visible": 30; "traff": 300; "relevance": 5; "our_relevance": 11 |
Параметри відповіді | |
Параметр |
Опис |
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
},
3.7. Рекламні оголошення
Метод SerpstatKeywordProcedure.getAdKeywords виконує пошук ключових слів в платній видачі та рекламних оголошень по ключовому слову. Аналогічний до звіту Аналіз ключових слів — РРС-аналіз — Рекламнi оголошення.
Загальні параметри запиту та інструкція щодо використання 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}}} |
json object |
так |
{"position": "asc", "region_queries_count":"desc"} |
{"cost": "asc"} |
page |
Номер сторінки у відповіді |
int |
так |
1 |
"page": "5" |
size |
Кількість результатів на сторінку у відповіді |
int |
так |
100 |
"size": "10" |
filters |
Умови фільтраціі |
array |
так |
|
"right_spelling": true; "right_spelling": false minus_domain : www.domain.com subdomain : blog.domain.com url (exact_url) : https://www.apple.com/airpods/ types : "carousel", "also_asks" keyword_length : num "region_queries_count": "1000"; "region_queries_count_wide": "1000"; "position": 1 "cost": "10"; "concurrency": "7"; "difficulty": 3; |
Для фільтрації результатів використовуйте наступні параметри:
Параметр | Опис | Можливі значення |
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
},
3.8. Конкуренти у платній видачі
Метод SerpstatDomainProcedure.getAdsCompetitors повертає список доменів-конкурентів в платній видачі. Аналогічний до звіту «Конкуренти» у РРС-аналізі по домену.
Загальні параметри запиту та інструкція щодо використання Serpstat API
Доступні пошукові бази
Параметри запиту |
||||
Параметр |
Опис |
Опціональний |
Значение за замовчуванням |
Варіанти значень |
id |
Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення. |
ні |
1, test |
|
method |
Назва методу API |
ні |
SerpstatDomainProcedure.getAdsCompetitors |
|
params |
Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...] |
ні |
|
|
domain |
Имя домена |
ні |
nike.com |
|
se |
Ідентифікатор пошукової бази, по якій буде проходити пошук (доступні бази Google і Yandex на вибір, наприклад: g_us, y_157). |
ні |
g_us |
|
sort |
Порядок сортування результатів в форматі: |
так |
{"relevance":"desc"} |
{"ads":"desc"} |
page |
Номер сторінки у відповіді |
так |
1 |
"page": "1" |
size |
Кількість результатів на сторінку у відповіді |
так |
100 |
"size": "50" |
Параметри відповіді | |
Параметр | Опис |
id | Ідентифікатор відповіді: відповідає id в запиті |
result | Містить в собі відповідь |
data | Масив з даними |
domain | Домен |
keywords | Кількість ключових фраз, які використовує конкурент в контекстній рекламі; |
ads | Кількість оголошень |
intersected | Кількість ключових фраз, за якими і аналізований домен, і конкурент розміщують платні оголошення |
missing_keywords | Кількість клювочих фраз, за якими розміщує конкурент оголошення і які відсутні у аналізованого домену |
summary_info | Об'єкт з даними відповіді |
page | Номер сторінки |
left_lines | Кількість API рядків, що залишилися |
Ліміти: кількість списаних лімітів відповідає кількості отриманих результатів за запитом. Частина відповіді API, за яку знімається 1 ліміт:
{
"domain": "finishline.com",
"keywords": 495,
"ads": 453,
"intersected": 57,
"missing_keywords": 438
},