Звіти по ключовим словам
2.2.1. Ключові слова для фрази (keywords)
keywords
Метод виповняє повнотекстовий пошук по ключовому слову і надає дані по знайденим ключовим словам (кількість запитів, вартість за клік, рівень конкуренції).
Пагінація
Для пагінації необхідно використовувати параметри:
- page_size : кількість результатів на сторінку (за замовчуванням 100, максимум 1000)
- page : номер сторінки (за замовчуванням 1-а сторінка)
Для фільтрації результатів можно використовувати параметри:
| Параметр | Опис | Можливі значення |
| queries_from | Мінімальна кількість запитів у місяць | 0-100000000 |
| queries_to | Максимальна кількість запитів у місяць | 0-100000000 |
| cost_from | Минимальна вартість за клік | 0-200 |
| cost_to | Максимальна вартість за клік | 0-200 |
| concurrency_from | Мінімальне значення конкуренції | 1-100 |
| concurrency_to | Максимальне значення конкуренції | 1-100 |
Для сортування результату можно використовувати параметри:
- sort : поле по якому потрібно виконати сортування
- order : напрямок сортування (asc — за зростанням, desc — за спаданням)
| Метрика | Опис |
| result | Інкапсулює в собі відповідь |
| total | Кількість знайдених ключових фраз, за якими ранжується даний домен в топ-100 |
| keyword | Задана ключова фраза |
| cost | Ціна за клік, $ |
| concurrency | Конкуренція ключової фрази в PPC (0-100) |
| found_results | Кількість знаденних результатів за ключовою фразою "keyword" |
| region_queries_count | Частотність ключової фрази у вибраному регіоні |
| region_queries_count_wide | Частотність ключової фрази у широкій відповідності |
| geo_names | Список топонімів в масиві, якщо топонім присутній у ключовій фразі. Якщо ні — масив пустий. |
| social_domains | Соціальні домени, які знаходяться в топ-10 по заданій фразі |
| right_spelling | Рекомендація щодо виправлення для ключової фрази з орфографічною помилкою |
| keyword_length | Кількість слів, розділених пробілом в ключовій фразі |
| lang | Мова |
| status_msg | Відповідь: "OK" або "Error" повідомляє про вдалий або невдалий запит |
| status_code | Код відповіді "200" — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта) |
| left_lines | Кількість API рядків що залишилися |
| difficulty | Оцінка рівня конкуренції за ключовою фразою для просування в ТОП-10. Градація складності розраховується від 0 до 100, де: 0-20 - легко; 21-40 - середньо; 41-60 - складно; 61-100 - дуже складно. |
Частина відповіді API, за яку знімається 1 ліміт:
{
"region_queries_count": 2400,
"types": [
"related_search",
"also_asks",
"a_box_fsnippet"
],
"cost": 0.190875,
"social_domains": [],
"keyword_length": 2,
"concurrency": 26,
"geo_names": [],
"right_spelling": null,
"keyword": "example cv",
"found_results": 571000000,
"lang": "en"
}
2.2.2. Перегляд ключових слів (keyword_info)
keyword_info
Метод повертає дані по ключовому слову (кількість запитів, вартість за клік, рівень конкуренції, категорії).
| Метрика | Опис |
| result | Інкапсулює в собі відповідь |
| total | Кількість знайдених ключових фраз, за якими ранжується даний домен в топ-100 |
| keyword | Задана ключова фраза |
| difficulty | Оцінка рівня конкуренції за ключовою фразою для просування в ТОП-10. Градація складності розраховується від 0 до 100, де: 0-20 - легко; 21-40 - середньо; 41-60 - складно; 61-100 - дуже складно. |
| cost | Ціна за клік, $ |
| concurrency | Конкуренція ключової фрази в PPC (0-100) |
| found_results | Кількість знаденних результатів за ключовою фразою ""keyword"" |
| region_queries_count | Частотність ключової фрази у вибраному регіоні |
| region_queries_count_wide | Частотність ключової фрази у широкій відповідності |
| geo_names | Список топонімів в масиві, якщо топонім присутній у ключовій фразі. Якщо ні — масив пустий. |
| social_domains | Соціальні домени, які знаходяться в топ-10 по заданій фразі |
| right_spelling | Рекомендація щодо виправлення для ключової фрази з орфографічною помилкою |
| keyword_length | Кількість слів, розділених пробілом в ключовій фразі |
| lang | Мова |
| keyword_id | ID ключевої фрази в нашій базі |
| status_msg | Відповідь: "OK" або "Error" повідомляє про вдалий або невдалий запит |
| status_code | Код відповіді "200" — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта) |
| left_lines | Кількість API рядків що залишилися |
2.2.3. Пропозиції щодо пошуку ключових слів (suggestions)
suggestions
Метод виконує повнотекстовий пошук по пошуковим підказкам.
Пагінація
Для пагінації необхідно використовувати параметри:
- page_size : кількість результатів на сторінку (за замовчуванням 100, максимум 1000)
- page : номер сторінки (за замовчуванням 1-а сторінка)
| Метрика | Опис |
| result | Інкапсулює в собі відповідь |
| total | Кількість знайдених пошукових підказок |
| keyword | Пошукова підказка |
| geo_names | Список топонімів в масиві, якщо топонім присутній у ключовій фразі. Якщо ні — масив пустий. |
| status_msg | Відповідь: "OK" або "Error" повідомляє про вдалий або невдалий запит |
| status_code | Код відповіді "200" — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта) |
| left_lines | Кількість API рядків, що залишилися |
Частина відповіді API, за яку знімається 1 ліміт:
{
"keyword": "salt code example",
"geo_names": [],
"_id": "3a160a559f0575d1d06ab340de32455a"
}
2.2.4. Cхожі ключові слова (related_keywords)
related_keywords
Метод повертає схожі пошукові запити.
Пагінація
Для пагінації необхідно використовувати параметри:
- page_size : кількість результатів на сторінку (за замовчуванням 100, максимум 1000)
- page : номер сторінки (за замовчуванням 1-а сторінка)
Для сортування результату можно використовувати параметри:
- sort : поле по якому потрібно виконати сортування
- order : напрямок сортування (asc — за зростанням, desc — за спаданням)
| Метрика | Опис |
| result | Інкапсулює в собі відповідь |
| total | Кількість знайдених схожих фраз |
| keyword | Схожа фраза |
| region_queries_count | Частотність ключової фрази у вибраному регіоні |
| cost | Ціна за клік, $ |
| concurrency | Конкуренція ключової фрази в PPC (0-100) |
| geo_names | Список топонімів в масиві, якщо топонім присутній у ключовій фразі. Якщо ні — масив пустий. |
| types | Перелік додаткових запитів, які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше) |
| right_spelling | Рекомендація щодо виправлення для ключової фрази з орфографічною помилкою |
| weight | Сила зв’язку схожих фраз |
| status_msg | Відповідь: "OK" або "Error" повідомляє про вдалий або невдалий запит |
| status_code | Код відповіді "200" — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта) |
| left_lines | Кількість API рядків, що залишилися |
Частина відповіді API, за яку знімається 1 ліміт:
{
"keyword": "example dictionary",
"region_queries_count": 70,
"cost": 0,
"concurrency": 0,
"geo_names": [
],
"types": [
"pic",
"refine_by_brand",
"related_search",
"also_asks"
],
"right_spell": null,
"right_spelling": null,
"weight": 6
}
2.2.5. Toп для ключової фрази (keyword_top)
keyword_top
Метод повертає останній топ по ключовій фразі.
| Метрики | Опис |
| result | Інкапсулює в собі відповідь |
| results | Кількість результатів |
| top | Інкапсулює результат |
| url | Сторінка, яка знаходиться на позиції (вказано в ""position"") |
| domain | Домен |
| position | Позиція ключової фрази в пошуковій видачі |
| ads | Інкапсулює результати контекстної реклами (якщо вона є) |
| status_msg | Відповідь: "OK" або "Error" повідомляє про вдалий або невдалий запит |
| status_code | Код відповіді "200" — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта) |
| left_lines | Кількість API рядків, що залишилися |
Частина відповіді API, за яку знімається 1 ліміт: