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

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

З 31.12.2021 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

Метод 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)

З 31.12.2021 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

Метод 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)

З 31.12.2021 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

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

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

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

З 31.12.2021 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

Метод 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)

З 31.12.2021 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

Метод 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)

З 31.12.2021 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

Метод 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)

З 31.12.2021 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

Метод 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. PPC фрази домену (ad_keywords)

З 31.12.2021 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

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

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

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

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

Для сортування результату можно використовувати параметри:
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)

З 31.12.2021 методи API v3 будуть недоступні. Скористайтеся аналогічним методом API v4.

Метод 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	Ідентифікатор пошукової бази, по якій буде проходити пошук (доступні бази Google і Yandex на вибір, наприклад: g_us, y_157).	ні	g_us

Параметри відповіді
Параметр	Опис
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	Ідентифікатор пошукової бази, по якій буде проходити пошук (доступні бази Google і Yandex на вибір, наприклад: g_us, y_157)	ні		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	Ідентифікатор пошукової бази, по якій буде проходити пошук (доступні бази Google і Yandex на вибір, наприклад: g_us, y_157).	ні		g_us
url	Посилання уточнення пошуку	так	null	https://www.nike.com/soccer
keywords	Масив ключових фраз, для яких буде відбуватися пошук	так	[]	["shop", "nike"]
minusKeywords	Масив мінус-слів при пошуку	так	[]	["nikes", "nke"]
filters	Умови фільтрації	так		{"right_spelling": true} {"right_spelling": false}
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

Параметри відповіді
Параметр	Опис
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	Ідентифікатор пошукової бази, по якій буде проходити пошук (доступні бази Google і Yandex на вибір, наприклад: g_us, y_157).	ні		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	Ідентифікатор пошукової бази, по якій буде проходити пошук (доступні бази Google і Yandex на вибір, наприклад: g_us, y_157).	ні		g_us
page	Номер сторінки у відповіді	так	1	"page": "5"
size	Кількість результатів на сторінку у відповіді	так	100	"size": "10" min: 1, max: 1000
filters	Умови фільтрації	так	true;false	{"right_spelling": true}

Параметри відповіді
Параметр	Описание
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	Ідентифікатор пошукової бази, по якій буде проходити пошук (доступні бази Google і Yandex на вибір, наприклад: g_us, y_157).	ні		g_us
filters	Умови фільтрації	так		{"queries_from": 30} {"queries_to": 40} {"right_spelling": true}
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	Ідентифікатор пошукової бази, по якій буде проходити пошук (доступні бази Google і Yandex на вибір, наприклад: g_us, y_157).	ні		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	Ідентифікатор пошукової бази, по якій буде проходити пошук (доступні бази Google і Yandex на вибір, наприклад: g_us, y_157).	ні		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

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

Параметри відповіді
Параметр	Опис
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	Ідентифікатор пошукової бази, по якій буде проходити пошук (доступні бази Google і Yandex на вибір, наприклад: g_us, y_157).	ні		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	Ідентифікатор пошукової бази, по якій буде проходити пошук (доступні бази Google і Yandex на вибір, наприклад: g_us, y_157).	ні		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 рядків, що залишилися