Анал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 "traff": 1000 |
Параметри відповіді | |
Параметр | Опис |
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"
Наприклад: {"ads":"desc"} | |
page | Номер сторінки у відповіді | int | так | 1 | "page": 1 (будь-яке числове значення) |
size | Кількість результатів на сторінку у відповіді | int | так | 100 | "size": 10 (будь-яке числове значення) |
filters | Умови фільтраціі | object | так | "visible": 30 "traff": 1000 | |
during_all_time | Період за який надається інформація у відповіді | boolean | так | false | true — отримати інформацію за весь перiод; |
Параметри відповіді | |
Параметр | Опис |
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" — Кількість ключових слів у базі даних |
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. | |
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}}} | так | {"position": "asc", "region_queries_count":"desc"} | {"cost": "asc"} |
page | Номер сторінки у відповіді | так | 1 | "page": "5" |
size | Кількість результатів на сторінку у відповіді | так | 100 | "size": "10" |
Параметри відповіді | |
Параметр | Опис |
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 | Порядок сортування результатів в форматі: | 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 - поле, по якому потрібно виконати сортування: | так | {"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 рядків, що залишилися |
Ліміти: кількість списаних лімітів відповідає кількості отриманих результатів за запитом. Частина відповіді 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.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" |
filters | Умови фільтрації | так | true;false | "right_spelling": true "misspelled": false "cost": 15 "concurrency": 50 "difficulty": 3 "region_queries_count": 10000 "region_queries_count_wide": 10000 "keyword_length": 1 "traff": 3000 "position": 1 "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 "misspelled": false "keywords": [ "red", "iphone"] "minus_keywords": ["blackberry", "nokia"] "queries": 400 "cost": 40 "concurrency": 30 "difficulty": 20 "region_queries_count": 10 "region_queries_count_wide": 100 "keyword_length": 1 "traff": 100 "position": 1 |
page | Номер сторінки у відповіді | так | 1 | "page": "5" |
size | Кількість результатів на сторінку у відповіді | так | 100 | "size": "10" |
Параметри відповіді | |
Параметр | Описание |
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.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}}} | так | {"relevance":"desc"} | {"ads":"desc"} |
page | Номер сторінки у відповіді | так | 1 | "page": "1" |
size | Кількість результатів на сторінку у відповіді | так | 100 | "size": "50" |
filters | Умови фільтрації | так |
| "visible": 35 "traff": 1000 "minus_domains": ["domain.com". "domain2.com] "exluded_competitors": ["domain.com". "domain2.com] "keywords": 1000 relevance : 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 рядків, що залишилися |
Ліміти: кількість списаних лімітів відповідає кількості отриманих результатів за запитом. Частина відповіді 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.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 - напрямок сортування (asc - по зростанню, desc - по спадаючій) | так | {"position": "asc", "region_queries_count":"desc"} | {"cost": "asc"} |
page | Номер сторінки у відповіді | так | 1 | "page": "1" |
size | Кількість результатів на сторінку у відповіді | так | 100 | "size": "50" |
filters | Умови фільтраціі | так |
| "position": 1 "queries": 5; "region_queries_count": "1000"; "region_queries_count_wide": "1000"; "cost": "10"; "concurrency": "7"; "difficulty": 3; "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 |
| |
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. | |
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" |
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" — Кількість трафіку в базі даних |
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"
},