Switch to english interface?

Анал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 рядків, що залишилися

Ліміти: кількість списаних лімітів відповідає кількості отриманих результатів за запитом. Частина відповіді 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"

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 рядків, що залишилися

Ліміти: Кількість списаних лімітів відповідає кількості отриманих результатів за запитом. Частина відповіді 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}}}

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 рядків, що залишилися

Ліміти: кількість списаних лімітів відповідає кількості отриманих результатів за запитом. Частина відповіді 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}}}

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"
            },

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

Ви впевнені?

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

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

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

Ім’я

Введіть адресу електронної пошти

Телефон

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

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

Відкрити чат технічної підтримки