Аналiз ключових слiв
4.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"] максимум 1000 ключових фраз у масиві | |
se | Ідентифікатор пошукової бази, по якій буде проходити пошук. | 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 рядків, що залишилися |
Ліміти: кількість списаних лімітів відповідає кількості отриманих ключових фраз у відповіді. За один запит можна отримати не більше 1000 результатів. Частина відповіді 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
},
4.2. Пiдбiр ключових фраз
Метод SerpstatKeywordProcedure.getKeywords метод представляє всі варіаціі аналізованої ключової фрази, за якою домени ранжуються в топ-100 органічної видачі Google, і надає дані за знайденими ключовими словами (кількість запитів, вартість за клік, рівень конкуренції та ін.). Аналогічний до звіту Аналіз ключових слів — SEO-аналіз — Підбір ключових фраз.
Загальні параметри запиту та інструкція щодо використання Serpstat API
Доступні пошукові бази
Параметри запиту | |||||
---|---|---|---|---|---|
Назва | Опис | Тип даних | Опціональний | Значення за замовчуванням | Варіанти значень |
id | Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. | int/string | ні | Текстове чи числове значення | |
method | Назва методу API | string | ні | SerpstatKeywordProcedure.getKeywords | |
params | Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...] | array | ні | ||
keyword | Фраза, для якої буде відбуватися пошук | string | ні | "iphone" (Будь-яке текстове значення) | |
se | Ідентифікатор пошукової бази, по якій буде проходити пошук. | string | ні | g_us (список пошукових баз) | |
minusKeywords | Список мінус-слів при пошуку | array | так | ["app", "apple"] — масив виключних ключових фраз | |
filters | Умови фільтраціі | array | так | Ціна: Частотність: Кількість слів у фразі: Складність: Конкуренція: Фрази з неправильним написанням: Ключові слова: | |
sort | Сортування за даними (за зростанням і спаданням) | array | так | "cost": "asc" "region_queries_count": "desc" | "keyword_length" — Сортування результатів за довжиною ключових фраз "difficulty" — Сортування результатів за рівнем конкуренції ключової фрази для просування у топ-10 "cost" — Сортування результатів за ціною за клік (у доларах США) "region_queries_count" — Сортування результатів за частотністю ключової фрази у обраному регіоні |
order | напрямок сортування | array | так | "cost": "asc" "region_queries_count": "desc" | Напрямок сортування ключових слів згідно вартості, конкуренції, частотності тощо (asc — за зростанням, desc — за спаданням) |
page | Номер сторінки у відповіді | int | так | 1 | "page": 5 (будь-яке числове значення) |
size | Кількість результатів на сторінку у відповіді | int | так | 100 | "size": 10 (будь-яке числове значення) min: 1, max: 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 | Мова |
keyword_length | Кількість слів, розділених пробілом в ключовій фразі |
difficulty | Оцінка рівня конкуренції за ключовою фразою для просування в топ-10 (від 0 до 100%) |
summary_info | Об'єкт з даними відповіді |
page | Номер сторінки |
total | Кількість знайдених варіацій ключових фраз |
left_lines | Кількість API рядків, що залишилися |
Ліміти: кількість списаних лімітів відповідає кількості отриманих ключових фраз у відповіді. За допомогою API запитів ви можете отримати лише перші 60000 результатів, незалежно від кількості та обсягу самих запитів. Для отримання більшої кількості даних - скористайтесь опцією експорту в розділах Аналіз домену, Аналіз ключової фрази або Аналіз URL, або зверніться до куратора за персональним вивантаженням результатів. Частина відповіді 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
},
4.3. Пошукові підказки
Метод 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 |
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": []
},
4.4. Схожі ключові фрази
Метод SerpstatKeywordProcedure.getRelatedKeywords повертає пошукові запити, які пов'язані з аналізованою ключовою фразою семантично. Аналогічний до звіту Аналіз ключових слів / Схожі фрази.
Загальні параметри запиту та інструкція щодо використання Serpstat API
Доступні пошукові бази
Параметри запиту | |||||
---|---|---|---|---|---|
Параметр | Опис | Тип даних | Опціональний | Значення за замовчуванням | Варіанти значень |
id | Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. | int/string | ні | Текстове чи числове значення | |
method | Назва методу API | string | ні | SerpstatKeywordProcedure.getRelatedKeywords | |
params | Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...] | array | ні | ||
keyword | Фраза, для якої буде відбуватися пошук | string | ні | iphone | |
se | Ідентифікатор пошукової бази, по якій буде проходити пошук. | string | ні | Например: g_us (список пошукових баз) | |
filters | Умови фільтраціі | array | так | Сила звʼязку схожих фраз: "weight":{weight_from} — Сила звʼязку від Фрази з неправильним написанням: Частотність: Складність: Доступні значення для types: map, pic, video, news, adv, calc, spec, graph, market, island, answer, carousel, sponsored, also_asks, map_local, a_box_c_converter, a_box_card, a_box_color_picker, a_box_dictionary, a_box_dtime, a_box_earthquake, a_box_flights, a_box_fsnippet, a_box_g_converter, a_box_map, a_box_nutrition, a_box_population, a_box_some, a_box_sports, a_box_stock, a_box_translation, a_box_weather, a_box_when_is, ads_bot, ads_top, bests, car_loan_calc, discover_places, kn_graph_brand, kn_graph_card, kn_graph_carousel_list, kn_graph_carousel_table, kn_graph_disambiguation, kn_graph_health, kn_graph_hotel_booking, kn_graph_local, local_pack, mortgage_calc, refine_by_brand, related_search, research, shopping_rhs, shopping_top, shopping_bottom, snip_breadcrumbs, snip_doc_type, snip_https, snip_image_thumbnail, snip_info, snip_reviews_stars, snip_search_box, snip_sitelinks, snip_twitter, snip_video_thumbnail, snip_feedback, snip_also_ask, snippet_steps_list, prices, top_stories, adv_banner, afisha, auto, avia, collections, companies, converter, entity, fact, homonyms, math, metro, music, oplata, pogoda, radio, rasp, realty, related, snippet_dates, snippet_file, snippet_image, snippet_recipe, snippet_list, snippet_price, snippet_rating, snippet_redir, snippet_showcase, snippet_sitelinks, snippet_social, snippet_table, snippet_video, sport, taxi, time, translate, travel, tv. (детальніше про спец-елементи SERP) Ключові фрази: "keyword_contain": string — Містить все (точна відповідність) Мова: | |
sort | Сортування за даними (за зростанням і спаданням) | array | так | "keyword" | "keyword" — Сортування результатів за абеткою "weight" — Сортування результатів за кількістю URL у топ-20 видачі |
order | Напрямок сортування | array | так | "desc" | Напрямок сортування (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 | Кількість URL в топ-20 видачі, які ранжуються за аналізованою фразою та фразою зі звіту. |
difficulty | Оцінка рівня конкуренції за ключовою фразою для просування в топ-10 (від 1 до 100) |
summary_info | Об'єкт з даними відповіді |
page | Номер сторінки |
total | Кількість знайдених схожих фраз |
left_lines | Кількість API рядків, що залишилися |
Ліміти: кількість списаних лімітів відповідає кількості отриманих результатів за запитом. За допомогою API запитів ви можете отримати лише перші 60000 результатів, незалежно від кількості та обсягу самих запитів. Для отримання більшої кількості даних - скористайтесь опцією експорту в розділах Аналіз домену, Аналіз ключової фрази або Аналіз URL, або зверніться до куратора за персональним вивантаженням результатів. Частина відповіді API, за яку знімається 1 ліміт:
{
"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
}
4.5. Топ за ключовою фразою
Метод SerpstatKeywordProcedure.getKeywordTop повертає останній топ-100 Google по ключовій фразі. Аналогічний до звіту Топ по фразі в Аналізі ключових слів.
Загальні параметри запиту та інструкція щодо використання 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 "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"
]
},
4.6. Конкуренти в пошуковій видачі
Метод 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}}} | 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
},
4.7. Рекламні оголошення
Метод SerpstatKeywordProcedure.getAdKeywords виконує пошук ключових слів в платній видачі та рекламних оголошень по ключовому слову. Аналогічний до звіту Аналіз ключових слів — РРС-аналіз — Рекламнi оголошення.
Загальні параметри запиту та інструкція щодо використання 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}}} | 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
},
4.8. Конкуренти у платній видачі
Метод SerpstatDomainProcedure.getAdsCompetitors повертає список доменів-конкурентів в платній видачі. Аналогічний до звіту «Конкуренти» у РРС-аналізі по домену.
Загальні параметри запиту та інструкція щодо використання Serpstat API
Доступні пошукові бази
Параметри запиту | ||||
Параметр | Опис | Опціональний | Значение за замовчуванням | Варіанти значень |
id | Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення. | ні | 1, test | |
method | Назва методу API | ні | SerpstatDomainProcedure.getAdsCompetitors | |
params | Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...] | ні |
| |
domain | Имя домена | ні | nike.com | |
se | Ідентифікатор пошукової бази, по якій буде проходити пошук. | ні | 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
},