Аналiз домену

2.1. Сумарний звіт за доменом

Метод SerpstatDomainProcedure.getDomainsInfo повертає сумарну інформацію по масиву доменів.

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

Доступні пошукові бази

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

Параметри відповіді
Параметр	Опис
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.10. Історія за доменом

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

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

Параметри запиту
Параметр	Опис	Тип даних	Опціонально	Значення за замовчуванням	Варіанти значень
id	Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення.	int/string	ні		Текстове або числове значення. Наприклад: 1, test
method	Назва методу API	string	ні		SerpstatDomainProcedure.getDomainsHistory
params	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]		ні
domain	Ім'я домену	string	ні		Текстове значення аналізуємого домену. Наприклад: nike.com
se	Ідентифікатор пошукової бази, по якій буде проходити пошук.	string	ні		g_us, g_ca доступні пошукові бази
sort	Порядок сортування результатів в форматі: {{{Field}}: {{order}}} field — поле, за яким потрібно виконати сортування order — напрямок сортування	object	так		field: "keywords" "traff" "visible" "visible_static" "new_keywords" "out_keywords" "rised_keywords" "down_keywords" "ad_keywords" "ads" "date" order: asc — за зростанням, desc — за спаданням Наприклад: {"ads":"desc"}
page	Номер сторінки у відповіді	int	так	1	"page": 1 (будь-яке числове значення)
size	Кількість результатів на сторінку у відповіді	int	так	100	"size": 10 (будь-яке числове значення) min: 1, max: 1000
filters	Умови фільтраціі	object	так		"visible": 30 "visible_from": 10 "visible_to": 50 "traff": 1000 "traff_from": 700 "traff_to": 5000
during_all_time	Період за який надається інформація у відповіді	boolean	так	false	true — отримати інформацію за весь перiод; false — отримати інформацію за рік.

Параметри відповіді
Параметр	Опис
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.11. Кількість ключових фраз домену в базах Serpstat

Метод SerpstatDomainProcedure.getRegionsCount повертає масив з інформацією про кількість ключів домену в базах даних Serpstat. Бази даних із кількістю ключів, що дорівнює нулю, не показуються у відповіді.

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

Параметри запиту
Параметр	Опис	Тип	Опціональний	Значення за замовчуванням	Варіанти значень
id	Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор.	int / string	ні		Чисельне або текстове значення
method	Назва методу API	string	ні		SerpstatDomainProcedure.getRegionsCount
params	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]		ні
domain	Імʼя аналізуємого домену	string	ні		ebay.com (Назва домену)
sort	Сортування за даними (за зростанням і спаданням)	string	так	"keywords_count"	"keywords_count" — Кількість ключових слів у базі даних "db_name" — Назва бази даних "country_name_en" — Назва країни пошукової системи "google_domain" — Імʼя домену пошукової системи
order	Напрям сортування (asc — за зростанням, desc — за спаданням)	array	так	"desc"	"order": "asc" / "desc"

Параметри відповіді
Параметр	Опис
id	Ідентифікатор відповіді: відповідає id в запиті
result	Містить в собі відповідь
data	Масив з даними відповіді
country_name_en	Назва країни пошукової системи
db_name	Назва бази даних
domain	Імʼя домену пошукової системи
keywords_count	Кількість ключових слів у базі даних
summary_info	Обʼєкт з даними відповіді
analysed_domain	Аналізований домен у вказаному запиті
sort	Порядок сортування результатів
order	Напрям сортування (asc — за зростанням, desc — за зменшенням)
regions_db_count	Кількість баз даних
total_keywords	Сумарна кількість ключів у всіх базах даних
left_lines	Кількість API рядків, що залишилися

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

{
                "country_name_en": "France",
                "db_name": "g_fr",
                "domain": "google.fr",
                "keywords_count": 1329046
            },

2.2. Ключові слова домену

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

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

Доступні пошукові бази

Параметри запиту
Параметр	Опис	Опціональний	Значення за замовчуванням	Варіанти значень
id	Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення.	ні		1, test
method	Назва методу API	ні		SerpstatDomainProcedure. getDomainKeywords
params	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]	ні
domain	Ім'я домену	ні		nike.com
se	Ідентифікатор пошукової бази, по якій буде проходити пошук.	ні		g_us
withSubdomains	Тип відстеження: з/без урахування піддоменів	так	true	true \| false
url	Посилання уточнення пошуку	так	null	https://www.nike.com/soccer
keywords	Масив ключових фраз, для яких буде відбуватися пошук	так	[]	["shop", "nike"]
minusKeywords	Масив мінус-слів при пошуку	так	[]	["nikes", "nke"]
filters	Умови фільтрації	так		{"right_spelling": true} {"right_spelling": false} {"position_dynamic": "new"} {"position_dynamic": "rise"} {"position_dynamic": "down"}
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.3. Конкуренти у платній видачі

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

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

Доступні пошукові бази

Параметри запиту
Параметр	Опис	Тип	Опціональність	Значення за замовчуванням	Варiанти значень
id	Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення.	int/string	нi		1, test
method	Назва методу API	string	нi		SerpstatKeywordProcedure.getAdsCompetitors
params	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]	array	нi
query	Фраза, для якої буде відбуватися пошук	string	нi		iphone
se	Ідентифікатор пошукової бази, для якої буде проходити пошук.	string	нi		g_us
page	Номер сторінки у відповіді	int	так	1	"page": "5"
pageSize	Кількість результатів на сторінку у відповіді	int	так	100	"pageSize": "100" min: 100, max: 1000
sort	Порядок сортування результатів в форматі: {{{Field}}: {{order}}} field - поле, по якому потрібно виконати сортування: * ads * all * common order - напрямок сортування (asc — за зростанням, desc — за спаданням)	json object	так		{"common": "desc"}

Параметры відповіді
Параметр	Опис
id	Ідентифікатор відповіді: відповідає id в запиті
result	Містить в собі відповідь
data	Масив з даними
domain	Домен-конкурент
ads	Кількість оголошень для домену
all	Кількість ключових фраз для домену у РРС
common	Спiльнi ключові фрази у РРС
summary_info	Об'єкт з даними відповіді
page	Номер сторінки
left_lines	Кількість API-рядків, що залишилися

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

{
    "domain": "verizon.com",
    "ads": 8953,
    "all": 30855,
    "common": 1437
},

2.4. Сторінки-лідери

Метод SerpstatDomainProcedure.getTopUrls виводить кількість ключових фраз, по яким сторінка ранжується в топі (топ-100 Google), орієнтовний трафік сторінки та кількість шейрів в соціальній мережі 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.apple.com/shop/buy-ipad" "url_contain": "buy-ipad" "url_not_contain": "buy-watch" "url": "https://www.apple.com/shop/watch/accessories" "minus_url": "https://www.apple.com/shop/iphone/accessories" "pm_url": "https://www.apple.com/"
page	Номер сторінки у відповіді	так	1	"page": "1"
size	Кількість результатів на сторінку у відповіді	так	100	"size": "50" min: 50, max: 1000

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

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

2.5. Порівняння доменів

Метод 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
filters	Умови фільтрації	так	true;false	"right_spelling": true "right_spelling": false "misspelled": false "cost": 15 "cost_from": 10 "cost_to": 50 "concurrency": 50 "concurrency_from": 10 "concurrency_to": 100 "difficulty": 3 "difficulty_from": 10 "difficulty_to": 15 "region_queries_count": 10000 "region_queries_count_from": 1000 "region_queries_count_to": 5000 "region_queries_count_wide": 10000 "region_queries_count_wide_from": 1000 "region_queries_count_wide_to": 5000 "keyword_length": 1 "keyword_length_from": 1 "keyword_length_to": 3 "traff": 3000 "traff_from": 1000 "traff_to": 5000 "position": 1 "position_from": 5 "position_to": 20 "keywords": [ "iphone", "iphone x"] "minus_keywords": [ "ipad", "iphone xr"]

Параметри відповіді
Параметр	Описание
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.6. Унікальні ключові слова доменів

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

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

Доступні пошукові бази

Параметри запиту
Параметр	Опис	Опціональний	Значення за замовчуванням	Варіанти значень
id	Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор. Допускається введення будь-якого числового (number) або текстового (string) значення.	ні		1, test
method	Назва методу API	ні		SerpstatDomainProcedure.getDomainsUniqKeywords
params	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]	ні
domains	Масив доменів (min 1, max 2)	ні		["nike.com", "adidas.com"]
minusDomain	Домен, ключові фрази якого, не повинні перетинатися з доменами параметра domains	ні		puma.com
se	Ідентифікатор пошукової бази, по якій буде проходити пошук.	ні		g_us
filters	Умови фільтрації	так		"right_spelling": false "right_spelling": true "misspelled": false "misspelled": true "keywords": [ "red", "iphone"] "minus_keywords": ["blackberry", "nokia"] "queries": 400 "queries_from": 50 "queriest_to": 2000 "cost": 40 "cost_from": 5 "cost_to": 20 "concurrency": 30 "concurrency_from": 10 "concurrency_to": 50 "difficulty": 20 "difficulty_from": 10 "difficulty_to": 40 "region_queries_count": 10 "region_queries_count_from": 30 "region_queries_count_to": 40 "region_queries_count_wide": 100 "region_queries_count_wide_from": 200 "region_queries_count_wide_to": 5000 "keyword_length": 1 "keyword_length_from": 3 "keyword_length_to": 4 "traff": 100 "traff_from": 2000 "traff_to": 5000 "position": 1 "position_from": 2 "position_to": 5
page	Номер сторінки у відповіді	так	1	"page": "5"
size	Кількість результатів на сторінку у відповіді	так	100	"size": "10" min: 1, max: 1000

Параметри відповіді
Параметр	Описание
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 рядків, що залишилися

{
    "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.7. Конкуренти в пошуковій видачі

Метод 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: 1, max: 1000
filters	Умови фільтрації	так		"visible": 35 "visible_from":30 "visible_to": 70 "traff": 1000 "traff_from": 500 "traff_to": 5000 "minus_domains": ["domain.com". "domain2.com] "exluded_competitors": ["domain.com". "domain2.com] "keywords": 1000 "keywords_from": 1000 "keywords_to": 5000 relevance : 10 relevance_from : 5 relevance_to : 10

Параметри відповіді
Параметр	Опис
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 рядків, що залишилися

 {
    "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.8. Рекламні оголошення домену

Метод 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
filters	Умови фільтраціі	так		"position": 1 "position_from": 2 "position_to": 10 "queries": 5; "queries_from": 7; "queries_to": 10 "region_queries_count": "1000"; "region_queries_count_to": "2000"; "region_queries_count_from": 300 "region_queries_count_wide": "1000"; "region_queries_count_wide_to": "1500"; "region_queries_count_wide_from": 100 "cost": "10"; "cost_to": "10"; "cost_from": 1 "concurrency": "7"; "concurrency_to": "7"; "concurrency_from": 1 "difficulty": 3; "difficulty_from": 5; "difficulty_to": 10 "minus_url": https://www.apple.com/airpods-2nd-generation/ "pm_url": https://www.apple.com/airpods/ "right_spelling": true$ "right_spelling": false "misspelled": true$ "misspelled": false

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

Параметр

Опис

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.9. Список URL-адрес домену

Метод 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
filters	Умови фільтраціі	так		{"url_prefix": "https://www.apple.com/ipad/"} {"url_contain": "/ipad/"} {"url_not_contain": "/mac/"}

Параметри відповіді
Параметр	Опис
id	Ідентифікатор відповіді: відповідає id в запиті
result	Містить в собі відповідь
data	Масив з даними
url	Сторінка домену
keywords	Кількість ключових фраз, за якими ранжується дана сторінка
summary_info	Об'єкт з даними відповіді
page	Номер сторінки
total	Кількість знайдених URL
left_lines	Кількість API рядків, що залишилися

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

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

2.92. Трафік домену в базах даних Serpstat

Метод SerpstatDomainProcedure.getAllRegionsTraffic повертає масив з інформацією про трафік в базах даних Serpstat. Бази даних із трафіком, що дорівнює нулю, не показуються у відповіді.

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

Параметри запиту
Параметр	Опис	Тип	Опціональний	Значення за замовчуванням	Варіанти значень
id	Ідентифікатор запиту: відповідь буде містити цей же ідентифікатор.	int / string	ні		Чисельне або текстове значення
method	Назва методу API	string	ні		SerpstatDomainProcedure.getAllRegionsTraffic
params	Об'єкт з параметрами {...}, в ньому перераховуються всі нижченаведені параметри та масиви [...]		ні
domain	Імʼя аналізуємого домену	string	ні		binance.com
sort	Сортування за даними (за зростанням і спаданням)	array	так	"traff"	"traff" — Кількість трафіку в базі даних "region" — назва регіону (наприклад ge, ua, uk) "country_name_en" — Назва країни пошукової системи "google_domain" — Імʼя домену пошукової системи
order	Напрям сортування (asc — за збільшенням, desc — за спаданням)	string	так	"desc"	"order": "asc" / "desc"

Параметри відповіді
Параметр	Опис
id	Ідентифікатор відповіді: відповідає id в запиті
result	Містить в собі відповідь
data	Масив з даними відповіді
country_name_en	Назва країни пошукової системи
region	Регіон домену (наприклад ge, ua, uk)
traff	Кількість трафіку в базі даних
google_domain	Імʼя домену пошукової системи
summary_info	Обʼєкт з даними відповіді
analysed_domain	Аналізований домен
sort	Порядок сортування результатів
order	Напрям сортування (asc — за збільшенням, desc — за спаданням)
regions_count	Кількість баз даних у відповіді
total_traff	Сумарна кількість трафіку у всіх базах даних
left_lines	Кількість API рядків, що залишилися

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

"g_sc": {
                "country_name_en": "Seychelles",
                "region": "sc",
                "traff": 97,
                "google_domain": "google.sc"
            },