Деякі функції обмежені.
Вхід Реєстрація

Ми використовуємо файли cookie для забезпечення працездатності сервісу, поліпшення навігації і маркетингових активностей Serpstat. Натискаючи "Прийняти та продовжити", ви погоджуєтеся з нашою Політики конфіденційності

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

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

right_spelling Фільтрація по фразам з неправильним написанням

not_contains - містить фрази з неправильним написанням;

contains - не містить фрази з неправильним написанням

Для сортування результату моливо використовувати параметри:

  • 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 - Метод виконує повнотекстовий пошук по пошуковим підказкам. Використовуйте параметр question = 1, щоб отримати лише запитання.

Пагінація

Для пагінації необхідно використовувати параметри:

  • 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_spelling": null,
"weight": 6
}

2.2.5. Toп для ключової фрази (keyword_top)

keyword_top — метод повертає останній топ 100 в Google або топ 50 в Яндекс по ключовій фразі.

Метрики Опис
result Інкапсулює в собі відповідь
results Кількість результатів
top Інкапсулює результат
url Сторінка, яка знаходиться на позиції (вказано в ""position"")
domain Домен
position Позиція ключової фрази в пошуковій видачі
ads Інкапсулює результати контекстної реклами (якщо вона є)
status_msg Відповідь: "OK" або "Error" повідомляє про вдалий або невдалий запит
status_code Код відповіді "200" — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків, що залишилися


Частина відповіді API, за яку знімається 1 ліміт:

{
"position": 1,
"url": "https://www.bestbuy.com/site/computers-pcs/laptop-computers/abcat0502000.c?id=abcat0502000",
"domain": "bestbuy.com",
"subdomain": "www.bestbuy.com",
"types": [
"related_search",
"snip_info"
]
}

2.2.8. Найпопулярніші фрази (top_words)

top_words - метод для пошуку популярних слів для побудови пошукових питань. Використовуйте параметр question = 1, щоб проаналізувати лише запитання.

Пагінація

Для пагінації необхідно використовувати параметри:

  • page_size : кількість результатів на сторінку (за замовчуванням 100, максимум 1000)
  • page :  номер сторінки (за замовчуванням 1-а сторінка)

Метрика Опис
result Інкапсулює в собі відповідь
total Кількість знайдених ключових фраз, за якими ранжується даний домен в топ-100
keyword Популярне слово для шуканої фрази
hits масив знайдених топ слів для шуканої фрази
cnt  в скількох фразах зустрічається слово keyword
status_msg Відповідь: "OK" або "Error" повідомляє про вдалий або невдалий запит
status_code Код відповіді "200" — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків що залишилися

Частина відповіді API, за яку знімається 1 ліміт:

{
       "keyword": "series",
       "cnt": 1
}

2.2.9. Ключові слова для фрази V4 (SerpstatKeywordProcedure.getKeywords)

SerpstatKeywordProcedure.getKeywords - метод виконує повнотекстовий пошук за ключовою фразою і надає дані по знайденим ключовим фразам (частотність, вартість за клік, рівень конкуренції).

Параметри запиту:

Назва Опис Тип даних Опціональний Значение за замовчуванням Варіанти значень
keyword Фраза, для якої буде відбуватися пошук string ні   купити машину
se Ідентифікатор пошукової бази, по якій буде проходити пошук string ні   g_ua, g_ru, ...
minusKeywords Список мінус-слів при пошуку array так [ ] порожній масив  
filters Умови фільтраціі array так {"cost_from": 0.1} 
sort

Порядок сортування результатів в форматі:
{{{Field}}: {{order}}}

field - поле, по якому потрібно виконати сортування
order - напрямок сортування (asc - по зростанню, desc - по спадаючій)

array так ['cost' => 'asc', 'region_queries_count' => 'desc']

{"keyword": "desc"} 

или

['cost' => 'asc', 'region_queries_count' => 'desc']

page Номер сторінки у відповіді int так 1  5
size Кількість результатів на сторінку у відповіді int так 100 "size": {{page_size}}

min: 1, max: 1000

Сортування результатів можливо за такими полями:

Параметр
cost
concurrency
found_results
region_queries_count
region_queries_count_wide
keyword_length

Для фільтрації результатів використовуйте наступні параметри:

Параметр Опис Можливі значення 
queries_from Мінімальна частотність в місяць  0-100000000
queries_to Максимальна частотність в місяць  0-100000000
cost_from Мінімальна вартість за клік  0-200
cost_to Максимальна вартість за клік  0-200
concurrency_from Мінімальне значення конкуренції ключової фрази в PPC  0-100
concurrency_to Максимальне значення конкуренції ключової фрази в PPC  0-100
minus_keywords  Фільтрація за мінус-словами (список слів через кому)  string

Параметри відповіді:

Метрики Опис
result Інкапсулює в собі відповідь
total Кількість знайдених ключових фраз, за якими ранжується даний домен в топ-100 для Google і топ-50 для Яндекс.
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 Мова
left_lines Кількість API рядків, що залишилися

Ліміти: кількість списаних лімітів відповідає кількості отриманих ключових фраз у відповіді. За один запит можна отримати не більше 60000 результатів.

Частина відповіді API, за яку знімається 1 ліміт:

{
"keyword": "chrome google play music",
"cost": 0,
"concurrency": 14,
"found_results": 312000000,
"region_queries_count": 10,
"region_queries_count_wide": 0,
"types": [
  "pic",
  "related_search"
],
"geo_names": [
  
],
"social_domains": [
  "wikipedia",
  "reddit",
  "spotify"
],
"right_spelling": null,
"keyword_length": 4,
"lang": "en"
}

2.2.10. Дані за ключовим словом V4 (SerpstatKeywordProcedure.getKeywordsInfo)

SerpstatKeywordProcedure.getKeywordsInfo - метод повертає дані за ключовим словом.

Параметри запиту:

Назва Опис Тип даних Опціональний Значение за замовчуванням Варіанти значень
keyword Фраза, для якої буде відбуватися пошук string ні   купити машину
se Ідентифікатор пошукової бази, по якій буде проходити пошук string ні   g_ua, g_ru, ...
filters

Порядок сортування результатів в форматі:
{{{Field}}: {{order}}}

field - поле, по якому потрібно виконати сортування
order - напрямок сортування (asc - по зростанню, desc - по спадаючій)

array так [ ] 
порожній масив

{"cost": "desc"} 

Сортування результатів можливо за такими полями:

Параметр
cost
concurrency
found_results
region_queries_count
region_queries_count_wide
region_queries_count_phrase

Параметри відповіді:

Метрики Опис
result Інкапсулює в собі відповідь
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 Кількість слів, розділених пропуском в ключовій фразі
difficulty Рівень конкуренції за ключовою фразою для просування в топ-10 органічної видачі
lang Мова
suggestions_count Кількість пошукових підказок
keywords_count Кількість ключових фраз
left_lines Кількість API рядків, що залишилися

Ліміти: кількість списаних лімітів відповідає кількості отриманих ключових фраз у відповіді. За один запит можна отримати не більше 60000 результатів.

Частина відповіді API, за яку знімається 1 ліміт:

{
"keyword": "купить машину",
"cost": 0.10480200000000001,
"concurrency": 48,
"found_results": 138000000,
"region_queries_count": 33100,
"region_queries_count_wide": 135000,
"region_queries_count_phrase": 0,
"types": [
    "pic",
    "local_pack",
    "related_search",
    "video",
    "kn_graph_carousel_list"
],
"geo_names": [],
"social_domains": [
    "pinterest"
],
"right_spelling": null,
"lang": "ru",
"suggestions_count": 38384,
"keywords_count": 277261
}

2.2.11. Пошукові підказки за ключовою фразою V4 (SerpstatKeywordProcedure.getSuggestions)

SerpstatKeywordProcedure.getSuggestions - метод виконує повнотекстовий пошук по пошуковим підказкам.

Параметри запиту:

Назва Опис Тип даних Опціональний Значение за замовчуванням Варіанти значень
keyword Фраза, для якої буде відбуватися пошук string ні   купити машину
se Ідентифікатор пошукової бази, по якій буде проходити пошук string ні   g_ua, g_ru, ...
page Номер сторінки у відповіді int так 1 5
size Кількість результатів на сторінку у відповіді int так 100 50-1000

Параметри відповіді:

Метрики Опис
result Інкапсулює в собі відповідь
total Кількість знайдених ключових фраз, за якими ранжується даний домен в топ-100 для Google і топ-50 для Яндекс.
keyword Задана ключова фраза
geo_names Список топонімів в масиві, якщо топонім присутній в ключовій фразі. Якщо немає - масив порожній.
left_lines Кількість API рядків, що залишилися

Частина відповіді API, за яку знімається 1 ліміт:

{
"keyword": "beardedspice google play music",
"geo_names": [
]
}

2.2.12. Схожі ключові фрази V4 (SerpstatKeywordProcedure.getRelatedKeywords)

SerpstatKeywordProcedure.getRelatedKeywords - метод повертає схожі ключові фрази.

Параметри запиту:

Назва Опис Тип даних Опціональний Значение за замовчуванням Варіанти значень
keyword Фраза, для якої буде відбуватися пошук string ні   купити машину
se Ідентифікатор пошукової бази, по якій буде проходити пошук string ні   g_ua, g_ru, ...
filters Умови фільтраціі array так

Сила зв'язку схожих фраз

{"Weight": {{weight_from}}

page Номер сторінки у відповіді int так 1 5
size Кількість результатів на сторінку у відповіді int так 100 50-1000

Сортування результатів можливо за такими полями:

Параметр
cost
region_queries_count
concurrency
weight

Параметри відповіді:

Метрики Опис
result Інкапсулює в собі відповідь
total Кількість знайдених ключових фраз, за якими ранжується даний домен в топ-100 для Google і топ-50 для Яндекс.
keyword Задана ключова фраза
region_queries_count Частотність ключової фрази в обраному регіоні
cost Ціна за клік, $
concurrency Конкуренція ключевої фрази в PPC (0-100)
geo_names Список топонімів в масиві, якщо топонім присутній в ключовій фразі. Якщо немає - масив порожній.
types Список додаткових елементів які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше).
right_spelling Рекомендація до виправлення для ключової фрази з орфографічною помилкою
weight Сила зв'язку схожих фраз
left_lines Кількість API рядків, що залишилися

Ліміти: кількість списаних лімітів відповідає кількості отриманих результатів за запитом. За один запит можна отримати не більше 60000 результатів.

Частина відповіді API, за яку знімається 1 ліміт:

{
"keyword": "как телевизор купить",
"region_queries_count": 10,
"cost": 0,
"concurrency": 0,
"geo_names": [],
"types": [
    "related_search",
    "pic",
    "also_asks",
    "snip_breadcrumbs"
],
"right_spelling": null,
"weight": 6
}

2.2.13. Топ за ключовою фразою V4 (SerpstatKeywordProcedure.getKeywordTop)

SerpstatKeywordProcedure.getKeywordTop - метод повертає останній топ за ключовою фразою.

Параметри запиту:

Назва Опис Тип даних Опціональний Значение за замовчуванням Варіанти значень
keyword Фраза, для якої буде відбуватися пошук string ні   купити машину
se Ідентифікатор пошукової бази, по якій буде проходити пошук string ні   g_ua, g_ru, ...
filters Умови фильтраціі int так {"top_size": 100}

{"Top_size": 100}

top_size цифрове значення від 1 до 100

Параметри відповіді:

Метрики Опис
result Інкапсулює в собі відповідь
results Кількість результатів
top Інкапсулює в собі відповідь
url Сторінка яка знаходиться на позиції (вказано в "" position "")
domain Домен
subdomain Піддомен домену
position Позиція за ключовою фразою в пошуковій видачі
types Список додаткових елементів які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше)
text Текст рекламного оголошення (якщо є контекстна реклама)
title Тема рекламного оголошення (якщо є контекстна реклама)
ads Інкапсулює результати контекстної реклами (якщо вона є)
left_lines Кількість API рядків, що залишилися

Ліміти: кількість списаних лімітів відповідає кількості отриманих ключових фраз у відповіді. За один запит можна отримати не більше 60000 результатів.

Частина відповіді API, за яку знімається 1 ліміт:

{
"position": 1,
"url": "https://chrome.google.com/webstore/detail/google-play-music/icppfcnhkcmnfdhfhphakoifcfokfdhg?hl=ru",
"domain": "google.com",
"subdomain": "chrome.google.com",
"types": [
    "related_search",
    "ads_top",
    "video",
    "snip_breadcrumbs"
]
}

2.2.14. Конкуренти за ключовими словами V4 (SerpstatKeywordProcedure.getCompetitors)

SerpstatKeywordProcedure.getCompetitors - метод повертає конкурентів по заданій ключовою фразою.

Параметри запиту:

Назва Опис Тип даних Опціональний Значение за замовчуванням Варіанти значень
keyword Фраза для якої буде відбуватися пошук string ні   купити машину
se Ідентифікатор пошукової бази, по якій буде проходити пошук string ні   g_ua, g_ru, ...
sort

Порядок сортування результатів в форматі:
{{{Field}}: {{order}}}

field - поле, по якому потрібно виконати сортування
order - напрямок сортування (asc - по зростанню, desc - по спадаючій)

array так [ ] 
порожній масив

{"keyword": "desc"} 

или

{"visible": "asc"}

 

size Кількість результатів на сторінку у відповіді int так 100 "size": {{page_size}}

min: 1, max: 1000

Сортування результатів можливо за такими полями:

Параметр
visible
keywords
traff
visible_dynamic
keywords_dynamic
traff_dynamic
ads_dynamic
new_keywords
out_keywords
rised_keywords
down_keywords
ad_keywords
ads
intersected
relevance
our_relevance

Параметри відповіді:

Параметр

Описание

result

Інкапсулює в собі відповідь

domain

Домен

visible

Видимість сайту

keywords

Кількість знайдених ключових фраз в обраній пошуковій системі

traff

Індекс, який показує орієнтовний трафік на сайт (кількість відвідувачів)

visible_dynamic

Динаміка зміни видимості в порівнянні з останньою датою оновлення

keywords_dynamic

Зміна кількості ключових фраз за останні 2 тижні

traff_dynamic

Зміна трафіку за останні 2 тижні

ads_dynamic

Зміна кількості ключових фраз в контекстній рекламі

new_keywords

Кількість нових ключових фраз, які з'явилися у домену за останні N-днів

out_keywords

Кількість ключових фраз, які втратив домен за останні 2 тижні

rised_keywords

Ключові фрази, за якими зросли позиції за останні 2 тижні

down_keywords

Ключові фрази, за якими впали позиції за останні 2 тижні

ad_keywords

Кількість ключових фраз в PPC

ads

Інкапсулює результати контекстної реклами (якщо вона є)

intersected

Кількість фраз у домену, які містять шукану фразу

relevance

Загальна релевантність домену до шуканої фрази

our_relevance

Релевантність сайту

left_lines

Кількість API рядків, що залишилися

Ліміти: Кількість списаних лімітів відповідає кількості отриманих результатів за запитом. Частина відповіді API, за яку знімається 1 ліміт:

{
"domain": "olx.ua",
"visible": 12460.70378,
"keywords": 37491150,
"traff": 242167110,
"visible_dynamic": -1297.75913,
"keywords_dynamic": 607995,
"traff_dynamic": -14625413,
"ads_dynamic": 3385,
"new_keywords": 629063,
"out_keywords": 21068,
"rised_keywords": 28751,
"down_keywords": 74468,
"ad_keywords": 31033,
"ads": 30730,
"intersected": 12061,
"relevance": 0.03,
"our_relevance": 61.65
}

2.2.15. Рекламні оголошення за ключовою фразою V4 (SerpstatKeywordProcedure.getAdKeywords)

SerpstatKeywordProcedure.getAdKeywords - метод виконує пошук рекламних оголошень за ключовою фразою.

Параметри запиту:

Опис

Тип

Тип

Опціональність

Значення за замовчуванням

Варіанти значень

keyword

Фраза, для якої буде відбуватися пошук

string

ні

allo.ua

se

Ідентифікатор пошукової бази, по якій буде проходити пошук

string

ні

g_ua, g_ru, ...

domains

Список доменів, масив

array

так

[]

https://allo.ua

minusKeywords

Масив мінус-слів при пошуку

array

так

[]

["алло", "ало"]

filters

Умови фільтрації

json object

так

 

{"queries_from": 10} {"queries_to": 10}

sort

Порядок сортування результатів в форматі:

{{{Field}}: {{order}}}

field - поле, по якому потрібно виконати сортування

order - напрямок сортування (asc - по зростанню, desc - по спадаючій)

json object

так

{"position": "asc", "region_queries_count":"desc"}

{"cost": "asc"}

page

Номер сторінки у відповіді

int

так

1

5

size

Кількість результатів на сторінку у відповіді

int

так

100

50-1000


Сортування результатів можливе за такими полями:

Параметр
keyword_length
position
type
cost
concurrency
found_results
region_queries_count
region_queries_count_wide
region_queries_count_last

Для фільтрації результатів використовуйте наступні параметри:

Параметр Опис Можливі значення 
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

Метрики відповіді:

Метрики

Опис

result

Інкапсулює в собі відповідь

total

Кількість знайдених оголошень, які відображаються за запитами, що містять фразу

region_queries_count

Частотність ключової фрази у вибраному регіоні

region_queries_count_wide

Частотність ключової фрази у широкій відповідності

region_queries_count_last

Частотність ключової фрази за останній місяць

domain

Домен 

keyword_length

Кількість слів, розділених пробілом в ключовій фразі

keyword

Ключова фраза, за якою відображається оголошення

title

Заголовок оголошення

url

URL оголошення

text

Текст оголошення

found_results

Кількість знаденних результатів за ключовою фразою "keyword"

CRC

Контрольна сума для швидкого пошуку

cost

Ціна за клік, $

concurrency

Конкурентність в контекстній рекламі (0-100)

position

Позиції оголошень контекстній рекламі

date

Дата актуалізації оголошення

subdomain

Піддомен

type

Місце знаходження оголошення в SERP (1 - над; 2 - під; 3 - справа)

types

Перелік додаткових запитів, які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше)

geo_names

Список топонімів в масиві, якщо топонім присутній у ключовій фразі. Якщо ні — масив пустий

left_lines

Кількість API-рядків, що залишилися

Лимити: кількість списаних лімітів відповідає кількості отриманих результатів за запитом.

Частина відповіді API, за яку знімається 1 ліміт:

{
"keyword": "купить ноутбуки",
"keyword_length": 2,
"domain": "foxtrot.com.ua",
"subdomain": "www.foxtrot.com.ua",
"url": "https://www.foxtrot.com.ua/ru/shop/noutbuki.html",
"title": "Купить Ноутбуки в Фокстроте | В наличии. Выгодные цены",
"text": "Заказывайте в интернете - забирайте в удобное время в магазине Фокстрот! Кредит до 24 месяцев. Цена проверена. Официальная гарантия. Акции каждый день. Места: Киев, Харьков.",
"position": 1,
"type": 1,
"cost": 0.120833,
"concurrency": 100,
"found_results": 52700000,
"region_queries_count": 27100,
"region_queries_count_wide": 74000,
"types": [
  "ads_top",
  "related_search"
],
"geo_names": [
  
],
}

2.2.16. Парсинг частотності V4

2.2.20. Список конкурентів за ключовою фразою в РРС V4 (SerpstatKeywordProcedure.getAdsCompetitors)

SerpstatKeywordProcedure.getAdsCompetitors — метод виконує пошук доменів-конкурентів в РРС за ключовою фразою.

Параметри запиту
Параметр Опис Тип Опціональність Значення за замовчуванням Варiанти значень
query Фраза, для якої буде відбуватися пошук string нi купити ноутбук
se Ідентифікатор пошукової бази, для якої буде проходити пошук string нi g_ua
page Номер сторінки у відповіді int так 1 5
pageSize Кількість результатів на сторінку у відповіді int так 100 50-1000
sort

desc — за зменшенням;

asc   за зростанням

json object так {"common": "desc"}

Параметры відповіді
Параметр Опис
domain Домен-конкурент
ads Кількість оголошень для домену
all Кількість ключових фраз для домену у РРС
common Спiльнi ключові фрази у РРС
summary_info Блок зведеної інформації
page Поточна сторінка
left_lines Кількість API-рядків, що залишилися

Лiмiти: кількість списаних лімітів відповідає кількості отриманих результатів за запитом. Частина відповіді API, за яку знімається 1 ліміт:

{
"domain": "lenovo.ua",
"ads": 62,
"all": 62,
"common": 41
}


Поділіться статтею з вашими друзями

Вхід Реєстрація

Ви вичерпали ліміт запитів.

Або email
Забыли пароль?
Або email
Optional
Повернутися до авторизації

Не хвилюйтеся! Лише заповніть поле з вашою email адресою і ми вишлемо вам листа для відновлення паролю.

Ви впевнені?

Awesome!

To complete your registration you need to enter your phone number

Назад

Ми надіслали код підтвердження на ваш номер телефону

Your phone Resend code Залишилося запитів

Щось пішло не так.

Зв'яжіться з нашою службою підтримки
Або підтвердіть регістарціі за допомогою Телеграм бота Перейдіть за цим посиланням
Виберіть проєкт, по якому хочете отримувати дані

Знайомство з сервісом

Serpstat економить час, як і ми готові заощадити ваш, на знайомстві з ключовими можливостями сервісу.

Наш фахівець зв'яжеться з вами і за підсумком запропонує відповідний варіант, який може включати персональну демонстрацію, пробний період, навчальні статті та записи вебінарів, консультацію фахівця, а також комфортні умови для старту використання Serpstat.

Ім’я

Email

Телефон

Будемо раді вашому коментарю

Покращити план

Експорт недоступний для вашого тарифного плану. Вам необхідно поліпшити свій тариф до Lite або вище, щоб отримати доступ до інструменту. Детальніше

Sign Up Free

Дякуємо, ми зберегли ваші нові налаштування розсилок.

Запрошення
Просмотр Редактирование

E-mail
Повідомлення
Необов'язково
E-mail
Повідомлення
Необов'язково

У вас закінчилися ліміти

Ви досягли ліміту на кількість створених проєктів і більше не можете створювати нові проєкти. Збільште ліміти або видаліть існуючі проєкти.

Я хочу більше лімітів
Відкрити чат технічної підтримки