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

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

Звіт по домену

2.1.1. Сумарний звіт по домену (domain_info)

Метод domain_info повертає сумарну інформацію по домену: видимість, орієнтовний SEO трафік, кількість ключових слів, за якими домен ранжується в топ-100 Google або топ-50 Yandex та за якими домен розміщує оголошення. Аналогічний до звіту «Сумарний звіт», за винятком графіків та діаграм.

Загальні параметри запиту та інструкція щодо використання Serpstat API

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
domain Домен, за яким отримана інформація
visible Видимість сайту
keywords Кількість знайдених ключових фраз в заданій пошуковій системі
traff
Індекс, який показує орієнтовний трафік на сайт (кількість відвідувачів)
visible_dynamic Динаміка зміни видимості в порівнянні з останньою датою оновлення
keywords_dynamic Зміна кількості ключових фраз в порівнянні з останньою датою оновлення
traff_dynamic Зміна трафіку в порівнянні з останньою датою оновлення
ads_dynamic Динаміка зміни в оголошеннях PPC
date Дата поточної перевірки видимості, ключових фраз і трафіку
new_keywords Кількість нових ключових фраз, які з'явилися у домена в порівнянні з останньою датою оновлення
out_keywords Кількість ключових фраз, які втратив домен в порівнянні з останньою датою оновлення
rised_keywords Ключові фрази, у яких зросли позиції в порівнянні з останньою датою оновлення
down_keywords Ключові фрази, у яких впали позиції в порівнянні з останньою датою оновлення
ad_keywords Кількість ключових фраз в PPC
ads Кількість оголошень в PPC
prev_date Попередня дата перевірки
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків, що залишилися

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

{
    "domain": "nike.com",
    "visible": 222.88057000000001,
    "keywords": 2613344,
    "traff": 255497238,
    "visible_dynamic": 10.063649999999996,
    "keywords_dynamic": 9610,
    "traff_dynamic": 15189516,
    "ads_dynamic": -99,
    "date": "2021-05-13",
    "new_keywords": 40573,
    "out_keywords": 30963,
    "rised_keywords": 49642,
    "down_keywords": 43635,
    "ad_keywords": 1098,
    "ads": 840,
    "prev_date": "2021-04-29"
  }


Якщо вам потрібна консультація про можливості Serpstat для ваших задач, замовте безкоштовну 30-хвилинну демонстрацію.
Залишилися питання? Зверніться в чат техпідтримки.

2.1.2. Сумарний звіт по домену (domain_history)

Метод domain_history повертає історію зміни видимості та кількості фраз по домену.

Загальні параметри запиту та інструкція щодо використання Serpstat API

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
domain Домен, за яким отримана інформація
keywords Кількість знайдених ключових фраз в заданій пошуковій системі
traff Індекс, який показує орієнтовний трафік на сайт (кількість відвідувачів)
visible Видимість сайту
visible_static Динаміка зміни видимості в порівнянні з останньою датою оновлення
new_keywords Кількість нових ключових фраз, які з'явилися у домену за останні N днів
out_keywords Кількість ключових фраз, які втратив домен за останні N днів
rised_keywords Ключові фрази, у яких зросли позиції за останні N днів
down_keywords Ключові фрази, у яких впали позиції за останні N днів
ad_keywords Кількість ключових фраз в PPC
ads Кількість оголошень в PPC
date Дата перевірки певного елементу масиву
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків що залишилися

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

{
    "domain": "nike.com",
    "keywords": 2603734,
    "traff": 240307722,
    "visible": 212.81692000000001,
    "visible_static": 212.81692000000001,
    "visible_mysql": 0,
    "new_keywords": 32499,
    "out_keywords": 37326,
    "rised_keywords": 40518,
    "down_keywords": 43717,
    "ad_keywords": 1197,
    "ads": 929,
    "date": "2021-04-29"
},

2.1.3. Ключові слова в топі пошукової системи за доменом (domain_keywords)

Метод domain_keywords повертає ключові слова в топі пошукової системи по домену. Аналогічний до звіту Аналіз домену — SEO-аналіз — Ключові словаВи можете експортувати до 60 000 результатів, використовуючи цей метод. 

Загальні параметри запиту та інструкція щодо використання Serpstat API

Для пагінації необхідно використовувати параметри:
page_size: кількість результатів на сторінку (за замовчуванням 100, максимум 1000)
page: номер сторінки (за замовчуванням 1-а сторінка)

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

Параметр Опис Можливі значення
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 Мінімальне значення конкуренції  1-100
concurrency_to Максимальне значення конкуренції  1-100
url Фільтрація по url  string
keywords Фільтрація по словам (список слів через кому)  string
minus_keywords Фільтрація по мінус словам (список слів через кому)  string
exact_url Шукати тільки точне входження url  1 - активний
pm_url Шукати тільки часткове входження url  1 - активний


Для сортування результату можно використовувати параметри:
sort: поле по якому потрібно виконати сортування
order: напрямок сортування (asc — за зростанням, desc — за спаданням)

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
total Кількість знайдених ключових фраз, за якими ранжується даний домен в топі пошукової системи
hits
Містить в собі відповідь
domain Домен, який ранжується за ключовою фразою
subdomain Піддомен сайту, який відображається в пошуковій видачі за заданною фразою
keyword Ключова фраза, за якою ранжується заданий сайт
keyword_length Кількість слів, розділених пробілом в ключовій фразі
url URL, який відображається в пошуковій видачі за даним запитом
position Позиція домену за ключовою фразою в пошуковій видачі
types Перелік додаткових запитів, які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше)
found_results Кількість знаденних результатів за ключовою фразою «keyword»
cost Ціна за клік, $
concurrency Конкуренція ключової фрази в PPC (0-100%)
region_queries_count Частотність ключової фрази у вибраному регіоні
region_queries_count_wide Частотність ключової фрази у широкій відповідності
geo_names Список топонімів в масиві, якщо топонім присутній у ключовій фразі. Якщо ні — масив пустий.
traff Орієнтовний трафік за ключовим словом в залежності від частоти ключового слова та позиції
difficulty Оцінка рівня конкуренції за ключовою фразою для просування в топ-10 (від 0 до 100%)
dynamic Показує, як змінилася позиція заданої ключової фрази
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків, що залишилися

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

{
    "domain": "nike.com",
    "subdomain": "www.nike.com",
    "keyword": "nikews",
    "keyword_length": 1,
    "url": "https://www.nike.com/",
    "position": 1,
    "types": [
        "also_asks",
        "snip_search_box",
        "snip_breadcrumbs"
    ],
    "found_results": 1140000,
    "cost": 0.64000000000000001,
    "concurrency": 3,
    "region_queries_count": 20400000,
    "region_queries_count_wide": 0,
    "geo_names": [],
    "traff": 3058470,
    "difficulty": null,
    "dynamic": null,
    "_id": "4197266083-1"
},

2.1.4. Список URL-адрес домену (domain_urls)

Метод domain_urls виводить список URL-ів сайту і кількість ключових слів, за яким ранжується даний URL. Аналогічний звіту «Сторінки-лідери» в Аналізі домену, за винятком за інформації з трафіку та кількості шейрів в Facebook.

Загальні параметри запиту та інструкція щодо використання Serpstat API

Для пагінації необхідно використовувати параметри:
page_size: кількість результатів на сторінку (за замовчуванням 100, максимум 1000)
page: номер сторінки (за замовчуванням 1-а сторінка)

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

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

{
    "url": "https://www.nike.com/",
    "keywords": 66466
},

2.1.5. Порівняння доменів (domains_intersection)

Метод domains_intersection повертає спільні ключові слова для максимум 3х доменів. Аналогічний до звіту «Порівняння доменів».

Загальні параметри запиту та інструкція щодо використання Serpstat API

Для пагінації необхідно використовувати параметри:
page_size: кількість результатів на сторінку (за замовчуванням 100, максимум 1000)
page: номер сторінки (за замовчуванням 1-а сторінка)

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
total Кількість знайдених спільних ключових фраз
hits
Містить в собі відповідь
region_queries_count Частотність ключової фрази у вибраному регіоні
types Перелік додаткових запитів, які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше)
cost Ціна за клік, $
keyword_length Кількість слів, розділених пробілом в ключовій фразі
concurrency Конкуренція ключової фрази в PPC (0-100%)
geo_names Список топонімів в масиві, якщо топонім присутній у ключовій фразі. Якщо ні — масив пустий.
region_queries_count_wide Частотність ключової фрази у широкій відповідності
keyword Ключова фраза, за якою ранжуються сайти
found_results Кількість знайденних результатів за ключовою фразою
domain 1,2,3 Домен, який ранжується за ключовою фразою (1,2,3)
subdomain 1,2,3 Піддомен сайту, який відображається в пошуковій видачі за заданною фразою (1,2,3)
url 1,2,3 URL, який відображається в пошуковій видачі за даним запитом (1,2,3)
position 1,2,3
Позиції порівнювальних доменів (1,2,3) для заданого ключевого слова
dynamic 1,2,3 Показує, як змінилася позиція домену (1,2,3) за заданою ключовою фразою
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків що залишилися

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

 {
    "region_queries_count": 1,
    "types": [
        "video",
        "related_search",
        "also_asks",
        "snip_breadcrumbs"
    ],
    "cost": 0,
    "keyword_length": 6,
    "modified_date": "2020-06-25",
    "concurrency": 0,
    "geo_names": [],
    "traff": 0,
    "region_queries_count_wide": 0,
    "keyword": "shoes youth size 8 on sale",
    "found_results": 688000000,
    "domain3": "puma.com",
    "subdomain3": "us.puma.com",
    "url3": "https://us.puma.com/en/us/kids",
    "position3": 35,
    "dynamic3": -17,
    "domain1": "nike.com",
    "subdomain1": "www.nike.com",
    "url1": "https://www.nike.com/w/boys-sale-shoes-1onraz3yaepzy7ok",
    "position1": 18,
    "dynamic1": null,
    "domain2": "adidas.com",
    "subdomain2": "www.adidas.com",
    "url2": "https://www.adidas.com/us/kids-youth-shoes",
    "position2": 28,
    "dynamic2": -10
},

2.1.6. Загальні та унікальні ключові слова (domains_uniq_keywords)

Метод domains_uniq_keywords повертає унікальні ключові слова двух доменів без урахування ключових слів третього домену. Аналогічний до звіту «Порівняння доменів».

Загальні параметри запиту та інструкція щодо використання Serpstat API

Для пагінації необхідно використовувати параметри:
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

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
total Кількість знайдених унікальних ключових фраз, за якими ранжуються два домени, але не ранжується третій
hits
Містить в собі відповідь
region_queries_count Частотність ключової фрази у вибраному регіоні
types Перелік додаткових запитів, які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше)
cost Ціна за клік, $
keyword_length Кількість слів, розділених пробілом, в ключовій фразі
url URL сторінки, яка відображається в SERP по заданій ключовій фразі
concurrency Конкуренція ключової фрази в PPC (0-100%)
geo_names Список топонімів в масиві, якщо топонім присутній у ключовій фразі. Якщо ні — масив пустий.
region_queries_count_wide Частотність ключової фрази у широкій відповідності
domain Домен 1, який ранжується за ключовою фразою
subdomain Піддомен сайту, який відображається в пошуковій видачі за заданною фразою
dynamic Показує, як змінилася позиція домену за заданою ключовою фразою
position Позиція домену 1 за ключовою фразою в пошуковій видачі
keyword Ключова фраза, за якою ранжуються сайти
found_results Кількість знаденних результатів за ключовою фразою
"domain" Позиції вказаних доменів за ключовою фразою
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків що залишилися

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

 {
    "region_queries_count": 10,
    "types": [
        "carousel",
        "sponsored"
    ],
    "cost": 1.28,
    "keyword_length": 8,
    "url": "http://store.nike.com/us/en_us/pw/womens-tops-t-shirts/7ptZobp",
    "concurrency": 100,
    "geo_names": [],
    "region_queries_count_wide": null,
    "domain": "nike.com",
    "subdomain": "store.nike.com",
    "dynamic": null,
    "position": 47,
    "keyword": "womens red and white striped long sleeve t-shirt",
    "found_results": "4370000",
    "_id": "215854703-47",
    "adidas.com": 78,
    "nike.com": 47
},

2.1.7. Домени-конкуренти в пошуковій видачі (competitors)

Метод competitors виводить список доменів-конкурентів в топ-20 пошукової видачі. Аналогічний до звіту «Конкуренти» по домену.

Загальні параметри запиту та інструкція щодо використання Serpstat API

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
domain Домен
visible Видимість сайту
keywords Кількість знайдених ключових фраз по домену в заданій пошуковій системі
traff Індекс, який показує орієнтовний трафік на сайт (кількість відвідувачів)
visible_dynamic Динаміка зміни видимості в порівнянні з останньою датою оновлення
keywords_dynamic Зміна кількості ключових фраз в порівнянні з останньою датою оновлення
traff_dynamic Зміна трафіку в порівнянні з останньою датою оновлення
ads_dynamic Динаміка зміни в оголошеннях PPC
new_keywords Кількість нових ключових фраз, які з'явилися у домена в порівнянні з останньою датою оновлення
out_keywords Кількість ключових фраз, які втратив домен в порівнянні з останньою датою оновлення
rised_keywords Ключові фрази, у яких зросли позиції в порівнянні з останньою датою оновлення
down_keywords Ключові фрази, у яких впали позиції в порівнянні з останньою датою оновлення
ad_keywords Кількість ключових фраз в PPC
ads Кількість оголошень в PPC
intersected Кількість спільних фраз у домена та конкурента
not_intersected Кількість відсутніх фраз у домена, які є у конкурента
relevance Релевантність - наскільки близька тематика порівнюваних доменів (1-100%)
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків що залишилися

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

{
    "domain": "snipesusa.com",
    "visible": 6.7542200000000001,
    "keywords": 205235,
    "traff": 3678917,
    "visible_dynamic": -1.2196999999999996,
    "keywords_dynamic": -6195,
    "traff_dynamic": -383469,
    "ads_dynamic": 10,
    "new_keywords": 7363,
    "out_keywords": 13558,
    "rised_keywords": 5671,
    "down_keywords": 9733,
    "ad_keywords": 40,
    "ads": 38,
    "visible_mysql": 0,
    "intersected": 140871,
    "not_intersected": 64364,
    "relevance": 68.640000000000001,
    "new_relevance": 5.1799999999999997,
    "our_relevance": 5.2999999999999998
},

2.1.8. Рекламний звіт із зазначеним іменем домену (ad_keywords)

Метод ad_keywords виконує пошук ключових слів в платній видачі та рекламних оголошень по домену. Аналогічний до звіту Аналіз домену — РРС-аналіз — Ключові слова.

Загальні параметри запиту та інструкція щодо використання Serpstat API

Для пагінації необхідно використовувати параметри:
page_size: кількість результатів на сторінку (за замовчуванням 100, максимум 1000)
page: номер сторінки (за замовчуванням 1-а сторінка)

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

Параметр Опис Можливі значення
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 Мінімальне значення конкуренції  1-100
concurrency_to Максимальне значення конкуренції  1-100
url Фільтрація по url  string
keywords Фільтрація по словам (список слів через кому)  string
minus_keywords Фільтрація по мінус словам (список слів через кому)  string
exact_url Шукати тільки точне входження url  1 - активний
pm_url Шукати тільки часткове входження url  1 - активний
right_spelling Фільтрація по фразам з неправильним написанням

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

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


Для сортування результату можно використовувати параметри:
sort: поле по якому потрібно виконати сортування
order: напрямок сортування (asc — за зростанням, desc — за спаданням)

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
total Кількість знайдених ключових фраз в РРС за доменом
hits Містить в собі відповідь
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_last Частотність ключової фрази за останній місяць
types Перелік додаткових запитів, які відображаються в SERP (наприклад, відео, карусель зображень, карта та інше)
geo_names Список топонімів в масиві, якщо топонім присутній у ключовій фразі. Якщо ні — масив пустий.
difficulty Оцінка рівня конкуренції за ключовою фразою для просування в топ-10 (від 0 до 100%)
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків, що залишилися

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

 {
    "keyword": "nike koshes",
    "keyword_length": 2,
    "domain": "nike.com",
    "subdomain": "www.nike.com",
    "url": "https://www.nike.com/gb/w/sale-3yaep",
    "title": "Nike.com Official Clearance - Stock Up On Clearance Shoes",
    "text": "Nike Clearance Gear Gives You A Chance To Add Top-Flight Products To Your Collection. Find The Items That Match Your Style And Complete Your Look. Shop Clearance Now. Medical Workers Save 10% Shop With Nike Experts. Free Shipping for Members.",
    "position": 1,
    "type": "1",
    "cost": 0.29999999999999999,
    "concurrency": 100,
    "found_results": 64,
    "region_queries_count": 1000000,
    "region_queries_count_last": 10,
    "types": [
        "ads_top"
    ],
    "geo_names": [],
    "difficulty": null,
    "_id": "4754893372_1"
},

2.1.9. Сторінки-лідери домену (get_top_urls)

Метод get_top_url виводить сторінки аналізованого домена в ієрархічному порядку. Крім того, він показує кількість ключових фраз, по яким сторінка ранжується в топі (топ-100 Google або топ-50 Яндекс), орієнтовний трафік сторінки та кількість шейрів в соціальній мережі Facebook. Аналогічний звіту «Сторінки-лідери» в Аналізі домену.

Загальні параметри запиту та інструкція щодо використання Serpstat API

Для пагінації необхідно використовувати параметри:
page_size: кількість результатів на сторінку (за замовчуванням 100, максимум 1000)
page: номер сторінки (за замовчуванням 1-а сторінка)

Для сортування результату можно використовувати параметри:
sort: поле по якому потрібно виконати сортування
order: напрямок сортування (asc — за зростанням, desc — за спаданням)

Параметри відповіді
Параметр Опис
result Містить в собі відповідь
total Кількість знайдених сторінок у домена
hits
Містить в собі відповідь
url Сторінка домену
organic_keywords Кількість знайдених ключових фраз, за якими ранжується дана сторінка в топ-100 Google або Яндекс топ-50
facebook_shares Кількість шейрів в соціальній мережі Facebook
potencial_traff Орієнтовний трафік строрінки за ключовими фразами в залежності від частотності запиту і позиції домену
status_msg Відповідь: «OK» або «Error», повідомляє про вдалий або невдалий запит
status_code Код відповіді «200» — успішний запит. В інших випадках — перевищення лімітів (кількість одночасних запитів або обмеження щодо лімітів аккаунта)
left_lines Кількість API рядків, що залишилися

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

{
    "url": "https://www.nike.com/",
    "organic_keywords": 65134,
    "facebook_shares": 701305,
    "potencial_traff": 39481276
},

2.1.10. Сумарний звіт за доменом V4 (SerpstatDomainProcedure.getDomainsInfo)

Метод SerpstatDomainProcedure.getDomainsInfo повертає сумарну інформацію по масиву доменів. Аналогічний до звіту «Пакетний аналіз»за винятком інформації щодо профілю посилань.

Загальні параметри запиту та інструкція щодо використання Serpstat API

Параметри запиту
Параметр Опис Опціональність Варіанти значень
id Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення. ні 1, test
method Назва методу API ні SerpstatDomainProcedure.getDomainsInfo
params Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...] ні
domains Масив доменів ні ["nike.com", "adidas.com" ]
se Ідентифікатор пошукової бази, по якій буде проходити пошук ні g_us, y_213

Параметри відповіді
Параметр Опис
id Ідентифікатор відповіді: відповідає id в запиті
result Містить в собі відповідь
data Масив з даними
domain Домен, за яким отримана інформація
visible Видимість сайту
keywords Кількість знайдених ключових фраз в обраній пошуковій системі
traff
Індекс, який показує орієнтовний трафік на сайт (кількість відвідувачів)
visible_dynamic Динаміка зміни видимості в порівнянні з останньою датою оновлення
keywords_dynamic Зміна кількості ключових фраз в порівнянні з останньою датою оновлення
traff_dynamic Зміна трафіку в порівнянні з останньою датою оновлення
ads_dynamic Динаміка зміни в оголошеннях PPC
new_keywords Кількість нових ключових фраз, які з'явилися у домену в порівнянні з останньою датою оновлення
out_keywords Кількість ключових фраз, які втратив домен в порівнянні з останньою датою оновлення
rised_keywords Ключові фрази, за якими зросли позиції в порівнянні з останньою датою оновлення
down_keywords Ключові фрази, за якими впали позиції в порівнянні з останньою датою оновлення
ad_keywords Кількість ключових фраз в PPC
ads Кількість оголошень в PPC
prev_date Попередня дата перевірки
summary_info Об'єкт з даними відповіді
page Номер сторінки
left_lines Кількість API-рядків, що залишилися

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

{
    "domain": "adidas.com",
    "visible": 38.226520000000001,
    "keywords": 1360672,
    "traff": 54388418,
    "visible_dynamic": 0.47296000000000049,
    "keywords_dynamic": -5503,
    "traff_dynamic": -370839,
    "ads_dynamic": 66,
    "new_keywords": 21333,
    "out_keywords": 26836,
    "rised_keywords": 33457,
    "down_keywords": 31140,
    "ad_keywords": 203,
    "ads": 199,
    "prev_date": "2021-05-13"
}

Якщо вам потрібна консультація про можливості Serpstat для ваших задач, замовте безкоштовну 30-хвилинну демонстрацію.
Залишилися питання? Зверніться в чат техпідтримки.

2.1.11. Історія за доменом V4 (SerpstatDomainProcedure.getDomainsHistory)

Метод SerpstatDomainProcedure.getDomainsHistory повертає історію зміни видимості і кількості фраз по домену.

Загальні параметри запиту та інструкція щодо використання Serpstat API

Параметри запиту
Параметр Опис Опціонально Значення за замовчуванням Варіанти значень
id Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення. ні 1, test
method Назва методу API ні SerpstatDomainProcedure.getDomainsHistory
params Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...] ні
domain Ім'я домену ні nike.com
se Ідентифікатор пошукової бази, по якій буде проходити пошук ні g_us
sort Порядок сортування результатів в форматі: {{{Field}}: {{order}}}

field — поле, за яким потрібно виконати сортування:
* keywords
* traff
* visible
* visible_static
* new_keywords
* out_keywords
* rised_keywords
* down_keywords
* ad_keywords
* ads
* date

order — напрямок сортування (asc — за зростанням, desc — за спаданням)
так {"ads":"desc"}
page Номер сторінки у відповіді так 1 5
size Кількість результатів на сторінку у відповіді так 100 100-1000

Параметри відповіді
Параметр Опис
id Ідентифікатор відповіді: відповідає id в запиті
result Містить в собі відповідь
data Масив з даними
domain Домен, за яким отримана інформація
keywords Кількість знайдених ключових фраз у заданій пошуковій системі
traff Індекс, який показує орієнтовний трафік на сайт (кількість відвідувачів)
visible Видимість сайту
visible_static Динаміка зміни видимості в порівнянні з останньою датою оновлення
new_keywords Кількість нових ключових фраз, які з'явилися у домену за останні N днів
out_keywords Кількість ключових фраз, які втратив домен за останні N днів
rised_keywords Ключові фрази, у яких зросли позиції за останні N днів
down_keywords Ключові фрази, у яких впали позиції за останні N днів
ad_keywords Кількість ключових фраз в PPC
ads Кількість оголошень в PPC
date Дата перевірки певного елементу масиву
summary_info Об'єкт з даними відповіді
page Номер сторінки
total Кількість результатів за запитом
left_lines Кількість API-рядків, що залишилися

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

{
    "domain": "nike.com",
    "keywords": 2603734,
    "traff": 240307722,
    "visible": 212.81692,
    "visible_static": 212.81692,
    "new_keywords": 32499,
    "out_keywords": 37326,
    "rised_keywords": 40518,
    "down_keywords": 43717,
    "ad_keywords": 1197,
    "ads": 929,
    "date": "2021-04-29"
},

2.1.12. Ключові слова в топі пошукової системи по домену V4 (SerpstatDomainProcedure.getDomainKeywords)

Метод SerpstatDomainProcedure.getDomainKeywords повертає ключові слова в топі пошукової системи по домену. Аналогічний до звіту Аналіз домену — SEO-аналіз — Ключові словаВи можете експортувати до 60 000 результатів, використовуючи цей метод. 

Загальні параметри запиту та інструкція щодо використання Serpstat API

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

Параметр

Опис

Опціональний

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

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

id Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення. ні 1, test

method

Назва методу API

ні

SerpstatDomainProcedure.
getDomainKeywords

params

Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]

ні

domain

Ім'я домену

ні

nike.com

se

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

ні

g_us

url

Посилання уточнення пошуку

так

null

https://www.nike.com/soccer

keywords

Масив ключових фраз, для яких буде відбуватися пошук

так

[]

["shop", "nike"]

minusKeywords

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

так

[]

["nikes", "nke"]

filters

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

так

{"concurrency_from": "0",
"concurrency_to": "1"}

sort

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

field — поле, за яким потрібно виконати сортування:
* region_queries_count
* types
* cost
* keyword_length
* concurrency
* geo_names
* traff
* region_queries_count_wide
* dynamic
* position
* found_results

order — напрямок сортування (asc — за зростанням, desc — за спаданням)

так

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

{"cost": "asc"}

page

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

так

1

"page": "5"

size

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

так

100

"size": "10"

min: 1, max: 1000

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

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

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

Параметр

Опис

id

Ідентифікатор відповіді: відповідає id в запиті

result

Містить в собі відповідь

data

Масив з даними

domain Домен, який ранжується за ключовою фразою
subdomain Піддомен сайту, який відображається в пошуковій видачі за вашим запитом

keyword

Ключова фраза, за якою ранжується заданий сайт

keyword_length

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

url

URL, який відображається в пошуковій видачі по даному запиту

position

Позиція домену за ключовою фразою в пошуковій видачі

types

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

found_results

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

cost

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

concurrency

Конкуренція ключової фрази в PPC (0-100%)

region_queries_count

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

region_queries_count_wide

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

geo_names

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

traff

Орієнтовний трафік за ключовим словом в залежності від частоти ключового слова та позиції

difficulty

Оцінка рівня конкуренції за ключовою фразою для просування в топ-10 (від 0 до 100%)

right_spelling

Рекомендація до виправлення для ключової фрази з орфографічною помилкою

dynamic

Показує, як змінилася позиція заданої ключової фрази

summary_info Об'єкт з даними відповіді
page Номер сторінки

total

Кількість знайдених результатів

left_lines

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

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

{
    "domain": "nike.com",
    "subdomain": "www.nike.com",
    "keyword": "nike socer",
    "keyword_length": 2,
    "url": "https://www.nike.com/soccer",
    "position": 1,
    "types": [
        "shopping_rhs",
        "ads_top",
        "snip_breadcrumbs"
    ],
    "found_results": 90,
    "cost": 0.48,
    "concurrency": 100,
    "region_queries_count": 9900,
    "region_queries_count_wide": 0,
    "geo_names": [],
    "traff": 1484,
    "difficulty": 20.35,
    "right_spelling": "nike soccer",
    "dynamic": 0
},

2.1.13. Список URL-адрес домену V4 (SerpstatDomainProcedure.getDomainUrls)

Метод SerpstatDomainProcedure.getDomainUrls виводить список URL-ів сайту і кількість ключових слів, за яким ранжується даний URL. Аналогічний звіту «Сторінки-лідери» в Аналізі домену, за винятком за інформації з трафіку та кількості шейрів в Facebook.

Загальні параметри запиту та інструкція щодо використання Serpstat API

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

Параметр

Опис

Опціональний

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

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

id

Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення.

ні

1, test

method

Назва методу API

ні

SerpstatDomainProcedure.
getDomainUrls

params

Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]

ні

domain

Ім'я домену

ні

nike.com

se

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

ні

g_us

sort

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


field — поле, за яким потрібно виконати сортування:
* keywords

order — напрямок сортування (asc — за зростанням, desc — за спаданням)

так

{"keywords":"desc"}

{"keywords":"asc"}

page

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

так

1

"page": "5"

size

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

так

100

"size": "3"

min: 1, max: 1000

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

Параметр

Опис

id

Ідентифікатор відповіді: відповідає id в запиті

result

Містить в собі відповідь

data

Масив з даними

url Сторінка домену

keywords

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

summary_info

Об'єкт з даними відповіді

page

Номер сторінки

total

Кількість знайдених URL

left_lines

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

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

{
    "url": "https://www.nike.com/",
    "keywords": 64785
},

2.1.14. Порівняння доменів V4 (SerpstatDomainProcedure.getDomainsIntersection)

Метод SerpstatDomainProcedure.getDomainsIntersection повертає спільні ключові слова для максимум 3х доменів. Аналогічний до звіту «Порівняння доменів».

Загальні параметри запиту та інструкція щодо використання Serpstat API

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

Параметр

Опис

Опціональний

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

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

id Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення. ні 1, test
method Назва методу API ні SerpstatDomainProcedure.getDomainsIntersection

params

Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]

ні

domains

Масив доменів (min2, max3)

ні

["nike.com", "adidas.com"]

se

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

ні

g_us

page

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

так

1

"page": "5"

size

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

так

100

"size": "10"

min: 1, max: 1000

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

Параметр

Описание

id

Ідентифікатор відповіді: відповідає id в запиті

result

Містить в собі відповідь

data Масив з даними

region_queries_count

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

types Список додаткових елементів, які відображаються в SERP (наприклад, відео, карусель зображення, карта та інше)
cost Ціна за клік, $

keyword_length

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

concurrency Конкуренція ключової фрази в PPC (0-100%)
geo_names Список топонімів в масиві, якщо топонім присутній в ключовій фразі. Якщо немає - масив порожній.
traff Орієнтовний трафік за ключовим словом в залежності від частоти ключового слова та позиції
region_queries_count_wide Частотність ключової фрази в широкій відповідності

keyword

Ключова фраза, за якою ранжується заданий сайт

found_results

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

domain 1,2,3 Домен, який ранжується за ключовою фразою (1,2,3)
subdomain 1,2,3 Піддомен сайту, який відображається в пошуковій видачі за вашим запитом (1,2,3)

url 1,2,3

URL сторінки, яка відображається в SERP по заданій ключовій фразі (1,2,3)

position 1,2,3 Позиції порівнювальних доменів (1,2,3) для заданого ключевого слова

dynamic 1,2,3

Показує, як змінилася позиція домену (1,2,3) за заданою ключовою фразою

summary_info

Об'єкт з даними відповіді

page

Номер сторінки

total

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

left_lines

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

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

{
    "region_queries_count": 1,
    "types": [
        "video",
        "related_search",
        "also_asks",
        "snip_breadcrumbs"
        ],
    "cost": 0,
    "keyword_length": 6,
    "concurrency": 0,
    "geo_names": [],
    "traff": 0,
    "region_queries_count_wide": 0,
    "keyword": "shoes youth size 8 on sale",
    "found_results": 688000000,
    "domain3": "puma.com",
    "subdomain3": "us.puma.com",
    "url3": "https://us.puma.com/en/us/kids",
    "position3": 35,
    "dynamic3": -17,
    "domain1": "nike.com",
    "subdomain1": "www.nike.com",
    "url1": "https://www.nike.com/w/boys-sale-shoes-1onraz3yaepzy7ok",
    "position1": 18,
    "dynamic1": null,
    "domain2": "adidas.com",
    "subdomain2": "www.adidas.com",
    "url2": "https://www.adidas.com/us/kids-youth-shoes",
    "position2": 28,
    "dynamic2": -10
},

2.1.15. Загальні і унікальні ключові слова V4 (SerpstatDomainProcedure.getDomainsUniqKeywords)

Метод SerpstatDomainProcedure.getDomainsUniqKeyword повертає унікальні ключові слова двух доменів без урахування ключових слів третього домену. Аналогічний до звіту «Порівняння доменів».

Загальні параметри запиту та інструкція щодо використання Serpstat API

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

Параметр

Опис

Опціональний

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

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

id Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення. ні 1, test

method

Назва методу API

ні

SerpstatDomainProcedure.getDomainsUniqKeyword

params

Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]

ні

domains

Масив доменів (min 1, max 2)

ні

["nike.com", "adidas.com"]

minusDomain

Домен, ключові фрази якого, не повинні перетинатися з доменами параметра domains

ні

puma.com

se

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

ні

g_us

filters

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

так

{"queries_from": 30}
{"queries_to": 40}

page

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

так

1

"page": "5"

size

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

так

100

"size": "10"

min: 1, max: 1000

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

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

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

Параметр

Описание

id

Ідентифікатор відповіді: відповідає id в запиті

result

Містить в собі відповідь

data Масив з даними
date Дата перевірки пошукової видачі

region_queries_count

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

types

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

cost

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

keyword_length

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

url

URL, який відображається в пошуковій видачі по даному запиту

concurrency

Конкуренція ключової фрази в PPC (0-100%)

difficulty

Оцінка рівня конкуренції за ключовою фразою для просування в топ-10 (від 0 до 100%)

geo_names

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

right_spelling

Рекомендація до виправлення для ключової фрази з орфографічною помилкою

traff

Орієнтовний трафік за ключовим словом в залежності від частоти ключового слова та позиції

region_queries_count_wide

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

domain

Домен, який ранжується за ключовою фразою

subdomain

Піддомен сайту, який відображається в пошуковій видачі за вашим запитом

dynamic

Показує, як змінилася позиція заданої ключової фрази

position

Позиція домену за ключовою фразою в пошуковій видачі

keyword

Ключова фраза, за якою ранжується заданий сайт

found_results

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

domain.com Позиції вказаних доменів за ключовою фразою
summary_info Об'єкт з даними відповіді
page Номер сторінки

total

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

left_lines

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

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

{
    "date": "2020-05-01",
    "region_queries_count": 3600,
    "types": [
        "kn_graph_carousel_list",
        "pic",
        "related_search",
        "snip_breadcrumbs"
        ],
    "cost": 0.53000000000000003,
    "keyword_length": 1,
    "url": "https://www.nike.com/w/womens-hoodies-pullovers-5e1x6z6rive",
    "concurrency": 100,
    "difficulty": 19.431026858090227,
    "geo_names": [],
    "right_spelling": "long hoodie",
    "traff": 0,
    "region_queries_count_wide": 0,
    "domain": "nike.com",
    "subdomain": "www.nike.com",
    "dynamic": null,
    "position": 55,
    "keyword": "longhoodie",
    "found_results": 628000000,
    "adidas.com": 11,
    "nike.com": 55
},

2.1.16. Домени-конкуренти в пошуковій видачі V4 (SerpstatDomainProcedure.getCompetitors)

Метод SerpstatDomainProcedure.getCompetitors повертає список доменів-конкурентів в топ-20 пошукової видачі. Аналогічний до звіту «Конкуренти» по домену.

Загальні параметри запиту та інструкція щодо використання Serpstat API

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

Параметр

Опис

Опціональний

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

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

id Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення. ні 1, test
method Назва методу API ні SerpstatDomainProcedure.getCompetitors

params

Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]

ні

domain

Ім'я домену

ні

nike.com

se

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

ні

g_us

sort

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

field — поле, за яким потрібно виконати сортування:
* visible
* keywords
* traff
* visible_dynamic
* keywords_dynamic
* traff_dynamic
* ads_dynamic
* new_keywords
* out_keywords
* rised_keywords
* down_keywords
* ad_keywords
* ads
* intersected
* relevance
* new_relevance
* our_relevance

order — напрямок сортування (asc — за зростанням, desc — за спаданням)

так

{"relevance":"desc"}

{"ads":"desc"}

page

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

так

1

"page": "1"

size

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

так

100

"size": "50"

min: 50, max: 1000

Параметри відповіді
Параметр Опис
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 Кількість спільних фраз у домена та конкурента
not_intersected Кількість відсутніх фраз у домена, які є у конкурента
relevance Релевантність - наскільки близька тематика порівнюваних доменів (1-100%)
summary_info Об'єкт з даними відповіді
page Номер сторінки
left_lines Кількість API рядків, що залишилися

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

 {
    "domain": "thesolesupplier.co.uk",
    "visible": 1.57363,
    "keywords": 273939,
    "traff": 987621,
    "visible_dynamic": 0.21043000000000012,
    "keywords_dynamic": 2761,
    "traff_dynamic": 82601,
    "ads_dynamic": 0,
    "new_keywords": 6341,
    "out_keywords": 3580,
    "rised_keywords": 11264,
    "down_keywords": 6878,
    "ad_keywords": 0,
    "ads": 0,
    "intersected": 192486,
    "not_intersected": 81453,
    "relevance": 70.27,
    "new_relevance": 7.04,
    "our_relevance": 7.26
},

2.1.17. Звіт за рекламою із зазначеним іменем домену V4 (SerpstatDomainProcedure.getAdKeywords)

Метод SerpstatDomainProcedure.getAdKeywords — метод виконує пошук ключових слів в платній видачі та рекламних оголошень по домену. Аналогічний до звіту Аналіз домену — РРС-аналіз — Ключові слова.

Загальні параметри запиту та інструкція щодо використання Serpstat API

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

Параметр

Опис

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

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

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

id Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення. ні

method

Назва методу API

ні

SerpstatDomainProcedure.getAdKeywords

params Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...] ні

domain

Iм'я домену

ні

nike.com

se

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

ні

g_us

url

Посилання для уточнення пошуку

так

 

https://www.nike.com/nike-by-you

keywords

Масив ключових фраз, для якого буде відбуватися пошук

так

[]

["nike", "id"]

minusKeywords

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

так

[]

["nikeid"]

filters

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

так

 

{ "concurrency_from": "0", "concurrency_to": "1" }

sort

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

field - поле, по якому потрібно виконати сортування:
keyword_length
position
type
cost
concurrency
found_results
region_queries_count
region_queries_count_wide
types
difficulty
geo_names

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

так

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

{"cost": "asc"}

page

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

так

1

"page": "1"

size

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

так

100

"size": "50"

min: 1, max: 1000

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

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

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

Параметр

Опис

result

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

total

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

hits

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

region_queries_count

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

region_queries_count_wide

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

region_queries_count_last

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

domain

Домен оголошення

keyword_length

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

keyword

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

title

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

url

URL оголошення, який відображається в пошуковій видачі за даним запитом

text

Текст оголошення, який відображається в пошуковій видачі  за даним запитом

found_results

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

url_crc

CRC код від змінної ""url""

CRC

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

cost

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

concurrency

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

position

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

date

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

keywords_id

ID ключової фрази в нашій базі

subdomain

Піддомен

type

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

types

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

geo_names

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

left_lines

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

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

{
"keyword": "gmail.coṃ",
"keyword_length": 1,
"domain": "google.com",
"subdomain": "gsuite.google.com",
"url": "https://gsuite.google.com/intl/ru/products/gmail/",
"title": "Рабочая почта Gmail от Google | Работайте там, где вам удобно",
"text": "Надежная почта, онлайн хранение, календарь, видеочат.",
"position": 1,
"type": 1,
"cost": 0.05,
"concurrency": 7,
"found_results": 13,
"region_queries_count": 74000,
"region_queries_count_wide": 0,
"types": [
  "pic",
  "ads_top"
],
"geo_names": [
 
]
}

2.1.18. Сторінки-лідери домену V4 (SerpstatDomainProcedure.getTopUrls)

Метод SerpstatDomainProcedure.getTopUrls виводить кількість ключових фраз, по яким сторінка ранжується в топі (топ-100 Google або топ-50 Яндекс), орієнтовний трафік сторінки та кількість шейрів в соціальній мережі Facebook. Аналогічний звіту «Сторінки-лідери» в Аналізі домену.

Загальні параметри запиту та інструкція щодо використання Serpstat API

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

Параметри запиту
Параметр Опис Опціональний Значення за замовчуванням Варіанти значень
id Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення. ні
method Назва методу API ні SerpstatDomainProcedure.getTopUrls
params Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...] ні
domain Ім'я домену ні   nike.com
se Ідентифікатор пошукової бази, по якій буде проходити пошук ні   g_us
sort

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

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

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

так {"organic_keywords":"desc"} {"organic_keywords":"asc"}
filters Умови фільтрації так

{"url_prefix": "https://www.nike.com/nike-by-you"}
{"url_contain": "nike-by-you"}
{"url_not_contain": "nike-by-you"}

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

min: 50, max: 1000

Параметри відповіді
Параметр Опис
id Ідентифікатор відповіді: відповідає id в запиті
result Інкапсулює в собі відповідь
data Масив з даними
url Сторінка домену
organic_keywords Кількість знайдених ключових фраз, за якими ранжується дана сторінка в топ-100 Google або Яндекс топ-50
facebook_shares Кількість шейрів в соціальній мережі Facebook
potencial_traff Орієнтовний трафік строрінки за ключовими фразами в залежності від частотності запиту і позиції домену
summary_info Об'єкт з даними відповіді
page Номер сторінки
total Всього знайдено результатів
left_lines Кількість API рядків, що залишилися

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

{
    "url": "https://www.nike.com/id/w/nike-by-you-running-shoes-37v7jz6ealhzy7ok",
    "organic_keywords": 39,
    "facebook_shares": 0,
    "potencial_traff": 540
},

2.1.19. Домени-конкуренти PPC V4 (SerpstatDomainProcedure.getAdsCompetitors)

Метод SerpstatDomainProcedure.getAdsCompetitors повертає список доменів-конкурентів в платній видачі. Аналогічний до звіту «Конкуренти» у РРС-аналізі по домену.

Загальні параметри запиту та інструкція щодо використання Serpstat API

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

Параметр

Опис

Опціональний

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

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

id

Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення.

ні

1, test

method

Назва методу API

ні

SerpstatDomainProcedure.getAdsCompetitors

params

Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]

ні

domain

Имя домена

ні

nike.com

se

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

ні

g_us

sort

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

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

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

так

{"relevance":"desc"}

{"ads":"desc"}

page

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

так

1

"page": "1"

size

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

так

100

"size": "50"

min: 50, max: 1000

Параметри відповіді
Параметр Опис
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
},

2.1.20. Cтатистика за лімітами V4 (SerpstatLimitsProcedure.getStats)

Метод SerpstatLimitsProcedure.getStats призначений для перевірки кількості доступних та використаних лімітів API та розширення Serpstat Website SEO Checker для браузерів.

Ліміти за використання цього методу не знімаються.

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

Параметр

Опис

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

id

Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення.

1, test

method

Назва методу API

SerpstatLimitsProcedure.getStats

Параметри відповіді
Параметр Опис Тип

id

Ідентифікатор відповіді: відповідає id в запиті

result

Містить в собі відповідь

data

Масив з даними

max_lines

Максимально доступна кількість API-лімітів на місяць int

used_lines

Кількість використаних API-лімітів int

left_lines

Кількість доступних API-лімітів int
user_info Інформація користувача API json object

user_id

Ідентифікатор користувача в Serpstat int

plugin_limits

Інформація щодо API-лімітів для розширення Serpstat для браузерів json object

hasApiPlugin

Наявність доступу до API-розширення для браузерів Serpstat:
true - є доступ
false - немає доступу
bool

delayBetweenRequests

Кількість запитів до API-розширення Serpstat для браузерів на секунду int
total Кількість лімітів на день для API-розширення Serpstat для браузерів int
used Кількість використаних лімітів за поточний день у API-розширенні int
left Кількість лімітів на поточний день до API розширення, що залишилися int
summary_info Об'єкт з даними відповіді
left_lines Кількість API рядків, що залишилися

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

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

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

Або 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
Повідомлення
Необов'язково

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

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

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