Анал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 | |
| withIntents | Інтент ключової фрази Цей параметр працює тільки для баз даних g_ua та g_us | boolean | так | false | true | false |
| 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"; intents_contain: ["informational", "navigational", "commercial", "transactional"]; | |
| Параметри відповіді | |
| Параметр | Опис |
| 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 | Кількість ключових фраз |
| intents | Інтенти аналізованої ключової фрази |
| summary_info | Об'єкт з даними відповіді |
| page | Номер сторінки |
| left_lines | Кількість API рядків, що залишилися |
Ліміти: кількість списаних лімітів відповідає кількості отриманих ключових фраз у відповіді. За один запит можна отримати не більше 1000 результатів. Частина відповіді API, за яку знімається 1 ліміт:
{
"region_queries_count": 1220000,
"region_queries_count_wide": 1000000,
"cost": 1.43,
"concurrency": 100,
"keyword": "iphone",
"found_results": 7450000000,
"types": [
"related_search",
"pic"
],
"geo_names": [],
"social_domains": [
"youtube",
"amazon",
"wikipedia",
"reddit"
],
"right_spelling": null,
"difficulty": 76,
"lang": "en",
"suggestions_count": 0,
"keywords_count": 54222
}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"] — масив виключних ключових фраз | |
| withIntents | Інтент ключової фрази Цей параметр працює тільки для баз даних g_ua та g_us | boolean | так | false | true | false |
| 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 | Мова |
| intents | Інтенти аналізованої ключової фрази |
| keyword_length | Кількість слів, розділених пробілом в ключовій фразі |
| difficulty | Оцінка рівня конкуренції за ключовою фразою для просування в топ-10 (від 0 до 100%) |
| summary_info | Об'єкт з даними відповіді |
| page | Номер сторінки |
| total | Кількість знайдених варіацій ключових фраз |
| left_lines | Кількість API рядків, що залишилися |
Ліміти: кількість списаних лімітів відповідає кількості отриманих ключових фраз у відповіді. За допомогою API запитів ви можете отримати лише перші 60000 результатів, незалежно від кількості та обсягу самих запитів. Для отримання більшої кількості даних - скористайтесь опцією експорту в розділах Аналіз домену, Аналіз ключової фрази або Аналіз URL, або зверніться до куратора за персональним вивантаженням результатів. Частина відповіді API, за яку знімається 1 ліміт:
{
"keyword": "iphone c price canada",
"cost": 0,
"concurrency": 0,
"found_results": 0,
"region_queries_count": 1,
"region_queries_count_wide": 0,
"types": [
"also_asks",
"a_box_fsnippet"
],
"geo_names": [
"canada"
],
"social_domains": [
"youtube",
"wikipedia"
],
"right_spelling": "iphone x price canada",
"lang": "en",
"keyword_length": 4
}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 (список пошукових баз) | |
| withIntents | Інтент ключової фрази Цей параметр працює тільки для баз даних g_ua та g_us | boolean | так | false | true | false |
| filters | Умови фільтрації | array | так | варіанти фільтрації перелічені в таблиці нижче | |
| 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 |
| Параметри фільтрації | |||
| Параметр | Опис | Тип даних | Варіанти значень |
| cost | Вартість ключової фрази за клік (у США $; точна відповідність) | float | будь-яке числове значення |
| cost_from | Вартість ключової фрази за клік (у США $; точна відповідність) від | float | будь-яке числове значення |
| cost_to | Вартість ключової фрази за клік (у США $; точна відповідність) до | float | будь-яке числове значення |
| concurrency | Конкуренція (наскільки складне просування фрази у топ від 1-100) | int | будь-яке ціле число в діапазоні 1-100 |
| concurrency_from | Конкуренція (наскільки складне просування фрази у топ від 1-100) від | int | будь-яке ціле число в діапазоні 1-100 |
| concurrency_to | Конкуренція (наскільки складне просування фрази у топ від 1-100) до | int | будь-яке ціле число в діапазоні 1-100 |
| keyword_length | Кількість слів у ключовій фразі | int | будь-яке числове значення |
| keyword_length_from | Кількість слів у ключовій фразі від | int | будь-яке числове значення |
| keyword_length_to | Кількість слів у ключовій фразі до | int | будь-яке числове значення |
| difficulty | Складність ключової фрази | float | будь-яке числове значення |
| difficulty_from | Складність ключової фрази від | float | будь-яке числове значення |
| difficulty_to | Складність ключової фрази до | float | будь-яке числове значення |
| region_queries_count | Частотність ключової фрази у вибраному регіоні | int | будь-яке ціле число |
| region_queries_count_from | Частотність ключової фрази у вибраному регіоні від | int | будь-яке ціле число |
| region_queries_count_to | Частотність ключової фрази у вибраному регіоні до | int | будь-яке ціле число |
| right_spelling | Відображати або не відображати ключові фрази з неправильним написанням | boolean | true або false |
| keyword_contain | Містить усі ключові фрази (точна відповідність) | string | будь-яке текстове значення |
| keyword_not_contain | Не містить усі ключові фрази (точна відповідність) | string | будь-яке текстове значення |
| keyword_contain_one_of | Містить одну ключову фразу з (точна відповідність) | string | будь-яке текстове значення |
| keyword_not_contain_one_of | Не містить одну ключову фразу з (точна відповідність) | string | будь-яке текстове значення |
| keyword_contain_broad_match | Містить усі ключові фрази (широка відповідність) | string | будь-яке текстове значення |
| keyword_not_contain_broad_match | Не містить усі ключові фрази (широка відповідність) | string | будь-яке текстове значення |
| keyword_contain_one_of_broad_match | Містить одну ключову фразу з (широка відповідність) | string | будь-яке текстове значення |
| keyword_not_contain_one_of_broad_match | Не містить одну ключову фразу з (широка відповідність) | string | будь-яке текстове значення |
| weight | Сила зв'язку | string | "weight_from" або "weight_to" |
| geo_names | Масив топонімів, якщо топонім присутній у ключовому слові | string | "contain" або "not_contain" |
| types | Тип спеціальних елементів на виході | array | Список можливих значень для types |
| intents_contain | Містить один або кілька інтентів | array | informational, navigational, commercial, transactional |
| intents_not_contain | Не містить один або кілька інтентів | array | informational, navigational, commercial, transactional |
| Параметри відповіді | |
| Параметр | Опис |
| 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) |
| intents | Інтенти аналізованої ключової фрази |
| 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.getKeywordFullTop повертає останній топ-100 Google по ключовій фразі. Аналогічний до звіту «Топ за фразою» в Аналізі ключових слів.
Загальні параметри запиту та інструкція щодо використання Serpstat API
Доступні пошукові бази
| Параметри запиту | |||||
| Параметр | Опис | Тип даних | Обов'язковий | Значення за замовчуванням | Варіанти значень |
| id | Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення | int/string | так | 1, test | |
| method | Назва методу API | string | так | SerpstatKeywordProcedure.getKeywordFullTop | |
| params | Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...] | array | так | ||
| keyword | Фраза, за якою буде відбуватись пошук | string | так | pizza | |
| se | Ідентифікатор пошукової бази, по якій буде проходити пошук. | string | так | g_us | |
| sort | Сортування за даними (за зростанням і спаданням) | array | ні | {"position": "asc"} | "position": "asc"/"desc" (asc — сортування за зростанням, desc — за спаданням) - Позиція у топ-100 "url": "asc"/"desc" - URL (asc - від A до Z; desc - від Z до A) "url_keywords_count": "asc"/"desc" - Кількість ключів за URL "domain": "asc"/"desc" - Домен (asc - від A до Z; desc - від Z до A) "domain_visibility": "asc"/"desc" - Видимість "domain_keywords_organic": "asc"/"desc" - Кількість ключів домену в органіці "domain_keywords_ppc": "asc"/"desc" - Кількість ключів домену в ррс "domain_top_10_keywords_count": "asc"/"desc" - Кількість ключів домену в топ-10 "domain_sdr": "asc"/"desc" - Serpstat Domain Rank "domain_in_urls_count": "asc"/"desc" - Кількість вхідних посилань домену "domain_in_domains_count": "asc"/"desc" - Кількість доменів, що посилаються "domain_out_urls_count": "asc"/"desc" - Кількість вихідних посилань домену "domain_out_domains_count": "asc"/"desc" - Кількість вихідних доменів |
| size | Кількість результатів у відповіді | int | ні | 100 | "size": "50" min: 10, max: 100 |
| Параметри відповіді | |
| Параметр | Опис |
| id | Ідентифікатор відповіді: відповідає id в запиті |
| result | Містить в собі відповідь |
| top | Масив з даними відповіді |
| position | Позиція за ключовою фразою в пошуковій видачі |
| url | Сторінка, яка знаходиться на вказаній позиції |
| url_keywords_count | Кількість ключових фраз у SEO, за якими URL-адреса знаходиться у топ-100 результатів Google. |
| domain | Домен, що ранжується за ключовою фразою |
| domain_visibility | Видимість домену в топ-20 пошукових результатів. Відносний показник, що розраховується виходячи зі співвідношення кількості й популярності ключових фраз, за якими сайт ранжується. Про видимість |
| domain_keywords_organic | Кількість ключових слів у SEO, за якими домен знаходиться у топ-100 результатів Google. |
| domain_keywords_ppc | Кількість ключових слів у РРС, за якими домен знаходиться у топ-100 результатів Google. |
| domain_top_10_keywords_count | Кількість ключових слів у SEO, за якими домен знаходиться у топ-10 результатів Google. |
| domain_sdr | Serpstat Domain Rank (SDR) — показник авторитетності домену |
| domain_in_urls_count | Кількість вхідних посилань домену |
| domain_in_domains_count | Кількість доменів, що посилаються |
| domain_out_urls_count | Кількість вихідних посилань домену |
| domain_out_domains_count | Кількість вихідних доменів |
| summary_info | Об'єкт з загальними даними відповіді |
| keywords | Кількість ключових слів у SEO (зі звіту Підбір ключових фраз) |
| frequency | Частотність ключової фрази |
| cost | Ціна за клік у $ США, яка оновлюється щомісячно |
| difficulty | Рівень конкуренції за ключовою фразою для просування в топ-10 органічної видачі |
| concurrency | Конкуренція ключевої фрази в PPC (0-100%) |
| types | Список додаткових елементів які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше) |
| sorting | Сортування запиту |
| left_limits | Кількість API рядків, що залишилися |
| count_top_results | Кількість результатів за запитом |
| keyword | Аналізована фраза |
| se | Використований регіон бази даних |
Ліміти: кількість списаних лімітів відповідає кількості отриманих результатів за запитом. Частина відповіді API, за яку знімається 1 ліміт:
{
"position": 26,
"url": "https://amblerpizza.com/",
"url_keywords_count": 741,
"domain": "amblerpizza.com",
"domain_visibility": 0.070000000000000007,
"domain_keywords_organic": 2360,
"domain_keywords_ppc": 0,
"domain_top_10_keywords_count": 145,
"domain_sdr": 30,
"domain_in_urls_count": 191,
"domain_in_domains_count": 53,
"domain_out_urls_count": 3619,
"domain_out_domains_count": 16
}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
},4.9. Сторінки-лідери
Метод SerpstatDomainProcedure.getTopUrls повертає список сторінок різних сайтів, які релевантні до шукомої ключової фрази та отримують більш за все трафіку як по цій фразі, так й за групою пов'язаних фраз.
Ідентичний звіту «Сторінки-лідери» у Аналізі ключових слів.
Загальні параметри запиту та інструкція щодо використання Serpstat API
Доступні пошукові бази
| Параметри запиту | |||||
| Параметр | Опис | Тип даних | Обов'язковий | Значенння за замовчуванням | Варіанти значень |
| id | Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення | int/string | так | Будь-яке текстове або числове значення. Наприклад: 1, test, тест | |
| method | Назва методу API | string | так | SerpstatDomainProcedure.getTopUrls | |
| params | Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...] | array | так | ||
| keyword | Фраза, за якою буде відбуватись пошук | string | так | Будь-яке текстове значення. Наприклад: "rebook" | |
| se | Ідентифікатор пошукової бази, за якою буде проводитись пошук. | string | так | g_us | |
| page | Номер сторінки | int | ні | 1 | Будь-яке числове значення |
| page_size | Кількість результатів у відповіді | int | ні | 20 | Текстове значення. Варіанти значень: 20, 50, 100, 200, 500 |
| sort | Сортування за даними | string | ні | keywords | "keywords" — Сортування за кількістю ключових слів |
| order | Напрям сортування | string | ні | desc | "desc" — Сортування за спаданням, "asc" — Сортування за зростанням |
| Параметри відповіді | |
| Параметр | Опис |
| id | Ідентифікатор відповіді: відповідає id в запиті |
| result | Містить в собі відповідь |
| urls | Масив з даними відповіді |
| url | URL шукомої фрази |
| keywords | Загальна кількість ключових фраз, за якими ранжується сторінку у Google топ-100 |
| traff | Орієнтовний трафік сторінки за ключовою фразою у залежності від частотності ключа та позиції домену. |
| fbShares | Кількість шейрів (репостів) у соціальній мережі Facebook |
| summary_info | Об'єкт із загальними даними відповіді |
| left_lines | Кількість API рядків, що залишилися |
| keyword | Аналізована фраза |
| se | Використана пошукова база |
| page | Номер сторінки |
| page_size | Розмір сторінки |
| sort | Сортування запиту |
| order | Напрям сортування запиту |
| total_urls | Загальна кількість знайдених результатів |
Ліміти: за 1 запит знімається 1 ліміт API.
4.97. Пошуковi питання та пiдказки
Метод SerpstatKeywordProcedure.exportSuggestions експортує в .csv файл пошукові підказки та запитання шукомої фрази. Дані аналогічні зі звітом «Аналіз ключових слів — SEO-аналіз — Пошукові підказки та Пошукові питання».
Загальні параметри запиту та інструкція щодо використання Serpstat API
Доступні пошукові бази
| Параметри запиту | |||||
| Параметр | Опис | Тип даних | Обов'язковий | Значення за замовчуванням | Варіанти значень |
| id | Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення | int/string | так | 1, test | |
| method | Назва методу API | string | так | SerpstatKeywordProcedure.exportKeywordsPhrase | |
| params | Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...] | array | так | ||
| keyword | Фраза, для якої буде відбуватися пошук | string | так | "iphone 13" | |
| se | Ідентифікатор пошукової бази, по якій буде проходити пошук. | string | так | g_us | |
| filters | Умови фільтрації | array | ні | "difficulty": 2 - Складність ключової фрази "cpc": 0.17 - Вартість ключової фрази (в US $; точне значення) "region_queries_count": 1000 - Частотність ключової фрази в обраному регіоні "keyword": "apple 10" - Фільтрація за ключовою фразою "keyword_length": 3 - Довжина ключової фрази "questions": Список можливих питань для кожного регіону | |
| withQuestions | З/без фраз, які включають питальні слова у звіті | string | ні | "true" - з питаннями, "false" - без питань | |
| size | Кількість результатів на сторінку у відповіді (min: 1, max: 1000) |
| ні | 500 | "size": "20" |
| page | Номер сторінки у відповіді | ні | 1 | "page": "5" | |
| Параметри відповіді | |
| Параметр | Опис |
| keyword | Ключова фраза |
| question | Питальне слово ключової фрази |
Ліміти: кількість списаних лімітів відповідає кількості отриманих ключових фраз у відповіді.
Частина відповіді API, за яку знімається 1 ліміт:
4.98. Топ за ключовою фразою (застарілий)
Метод SerpstatKeywordProcedure.getKeywordTop повертає останній топ-100 Google по ключовій фразі.
Цей запит застарілий. Будь ласка, використовуйте актуальний API запит Топа за фразою за цим посиланням.
Загальні параметри запиту та інструкція щодо використання 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"
]
},