API для анализа конкуренции в SEO/PPC

API для Анализа конкуренции в SEO/PPC позволяет в удобном виде получить статистику по конкурентам и ключевым словам в органической и платной выдаче.

Для доступа к разделу необходимо иметь активную подписку или средства на балансе.

Возвращает ошибки

HTTP codeСообщение об ошибке
403Empty balance
403Licence expired

Обзор домена (по выбранной базе)

Описание

Возвращает статистику по ключевым словам для органического или платного трафика по выбранной базе.

Формат запроса

GET https://api4.seranking.com/research/{source}/overview/?domain=domain.com

Параметры в запросе

ИмяОбязательныйОписание
sourceДаБаза, к которой производится запрос
domainДаДомен
with_subdomainsНет1 – учитывать субдомены (по умолчанию)
0 – не учитывать субдомены

Результат

В случае успеха сервер возвращает статистику по ключевым словам для органического или платного трафика по выбранной базе.

Пример

{
“organic”: {
“base_domain”:”domain.com”,
“keywords_new_count”: 182,
“keywords_up_count”: 292,
“keywords_equal_count”: 55,
“keywords_lost_count”: 282,
“top11_20”: 127,
“top51_100”: 331,
“keywords_down_count”: 558,
“top1_5”: 25,
“top21_50”: 270,
“top6_10”: 52,
“keywords_count”: 790,
“traffic_sum”: 3149,
“price_sum”: 23167.97,
“year”: 2022,
“month”: 8
},
“adv”: {
“base_domain”:”domain.com”,
“keywords_new_count”: 91,
“keywords_up_count”: 17,
“keywords_equal_count”: 18,
“keywords_lost_count”: 62,
“keywords_down_count”: 76,
“top1_2”: 53,
“top3_5”: 68,
“top6_8”: 19,
“top9_11”: 0,
“keywords_count”: 140,
“traffic_sum”: 2968,
“price_sum”: 17795.26,
“year”: 2022,
“month”: 8
}
}

Параметры ответа

ИмяОписание
organicДанные по органическому трафику
avdДанные по платному трафику
base_domainДомен
keywords_countКоличество ключевых слов
traffic_sumПрогноз трафика
price_sumОценка стоимости
top1_5Количество ключевых слов с позициями 1-5
top6_10Количество ключевых слов с позициями 6-10
top11_20Количество ключевых слов с позициями 11-20
top21_50Количество ключевых слов с позициями 21-50
top51_100Количество ключевых слов с позициями 51_100
top1_2Количество ключевых слов с позициями 1, 2 (для платного трафика)
top3_5Количество ключевых слов с позициями 3, 4, 5 (для платного трафика)
top6_8Количество ключевых слов с позициями 6, 7, 8 (для платного трафика)
top9_11Количество ключевых слов с позициями 9, 10, 11 (для платного трафика)
keywords_new_countКоличество ключевых слов
keywords_lost_countКоличество выпавших из выдачи слов
keyword_equal_countПозиции не изменились
keywords_up_countРост позиций
keywords_down_countПадение позиций
yearГод
monthМесяц

Ошибки

HTTP-кодСообщение об ошибке
400Invalid domain
400Invalid source

Обзор домена (история)

Описание

Метод позволяет получить исторические данные по параметрам (количество ключевых слов, клики, стоимость) для органического или платного трафика.

Формат запроса

GET https://api4.seranking.com/research/{source}/overview/history/?domain=domain.com&type=organic

Параметры в запросе

ИмяОбязательныйОписание
sourceДаБаза, к которой производится запрос
domainДаДомен
typeНетorganic – данные по органическому трафику (по умолчанию)
adv – данные по платному трафику

Результат

В случае успеха сервер возвращает исторические данные по параметрам для органического или платного трафика.

Пример

[
{
“keywords_count”: 51,
“traffic_sum”: 184,
“price_sum”: 1095.87,
“year”: 2016,
“month”: 9,
“top1_2”: 13,
“top3_5”: 18,
“top6_8”: 20,
“top9_11”: 0
},

]

Параметры ответа

ИмяОписание
keywords_countКоличество ключевых слов
traffic_sumПрогноз трафика
price_sumОценка стоимости
yearГод
monthМесяц
top1_5Количество ключевых слов с позициями 1-5
top6_10Количество ключевых слов с позициями 6-10
top11_20Количество ключевых слов с позициями 11-20
top21_50Количество ключевых слов с позициями 21-50
top51_100Количество ключевых слов с позициями 51_100
top1_2Количество ключевых слов с позициями 1, 2 (для платного трафика)
top3_5Количество ключевых слов с позициями 3, 4, 5 (для платного трафика)
top6_8Количество ключевых слов с позициями 6, 7, 8 (для платного трафика)
top9_11Количество ключевых слов с позициями 9, 10, 11 (для платного трафика)

Ошибки

HTTP-кодСообщение об ошибке
400Invalid domain
404Invalid source

Ключевые слова по домену

Описание

Метод позволяет получить список ключевых слов для домена.

Формат запроса

GET https://api4.seranking.com/research/{source}/keywords/?domain=domain.com&type=organic&order_field=position&order_type=desc&cols=position,prev_pos

Параметры в запросе

ИмяОбязательныйОписание
sourceДаБаза, к которой производится запрос
domainДаДомен
typeНетorganic – данные по органическому трафику (по умолчанию)
adv – данные по платному трафику
order_fieldНетПоле сортировки (по умолчанию traffic)
order_typeНетasc or desc (по умолчанию)
pageНетСтраница результатов (по умолчанию – 1)
limitНетКоличество элементов (по умолчанию – 100, максимум 1000)
colsНетСписок возвращаемых значений (через запятую)
pos_changeНетФильтр по изменению позиции:
up – рост позиций
down – падение позиций
new – новые в выдаче
lost – выпали из выдачи
diff – изменились позиции
same – позиция не изменилась

Результат

В случае успеха сервер возвращает список ключевых слов для домена и их параметры.

Пример

[
{
“keyword”: “seranking.com”,
“position”: 1,
“prev_pos”: 1,
“volume”: 10,
“cpc”: 0.00,
“competition”: 0.00,
“url”: “https://seranking.com/”,
“total_sites”: 88,
“traffic”: 3,
“traffic_percent”: 11.11,
“price”: 0
},

]

Параметры ответа

ИмяОписание
keywordКлючевое слово
positionПозиция
prev_posПозиция в предыдущем месяце
volumeЧастотность
cpcCPC
competitionКонкуренция
urlURL
total_sitesВсего сайтов по запросу
trafficТрафик
traffic_percentДоля трафика
priceСтоимость

Для платного трафика (type=adv) дополнительно к параметрам выше передаётся информация о рекламном объявлении

Пример

[
{
“keyword”: “nyc hotels”,
“position”: 4,
“prev_pos”: 4,
“volume”: 550000,
“cpc”: 3.75,
“competition”: 0.16,
“url”: “https://www.booking.com/city/us/new-york.html”,
“total_sites”: 851000000,
“traffic”: 11000,
“traffic_percent”: 0.96,
“price”: 41250,
“block”: “top”,
“snippet_num”: 579,
“snippets_count”: 1,
“snippet_title”: “Hotels in New York, NY | Lowest Price Guarantee.‎”,
“snippet_description”: “Book your Hotel in New York NY online. No reservation costs. Great rates. 24/7 Customer Service. Hotels. Secure Booking. Villas. Hostels. No Booking Fees. Best Price Guarantee.”,
“snippet_display_url”: “www.booking.com/city/us/new-york.html”
},

]

Параметры

blocktop | bottom – тип рекламного блока
snippet_numНомер объявления
snippets_countКоличество объявлений
snippet_titleЗаголовок
snippet_descriptionТекст объявления
snippet_display_urlОтображаемый URL

Ошибки

HTTP-кодСообщение об ошибке
400Invalid domain
400Invalid source
400Incorrect order
400Row limit exceeded

Платные объявления по ключевому слову

Описание

Метод позволяет получить обзор платных объявлений по ключевому слову.

Формат запроса

GET https://api4.seranking.com/research/{source}/advertising/?keyword=seo

Параметры в запросе

ИмяОбязательныйОписание
keywordДаКлючевое слово
fromНетГод и месяц начала периода (2017-01)
toНетГод и месяц окончания периода (2018-12)
pageНетСтраница результатов (по умолчанию – 1)
limitНетКоличество элементов (по умолчанию – 100, максимум 1000)

Результат

В случае успеха сервер возвращает обзор платных объявлений по ключевому слову.

Пример

[
{
“domain”: “hotels.com”,
“ads_count”: 19,
“keywords_count”: 78972,
“traffic_sum”: 3565364,
“price_sum”: 10411189,
“snippets”: {
2018-11: {
“position”: 2,
“snippet_title”: “Booking | Hotels.com‎”,
“snippet_description”: “Stay 10 nights & get 1 free! Redeem your
reward night anytime, anywhere. Last Minute Hotel Deals. Exclusive Deals. Photos & Reviews. Price Guarantee. Earn Free Hotel Nights. Guest Reviews. No Cancellation Fees. Travel Guides. Luxury Hotels. Budget Hotels.”,
“snippet_display_url”: “www.hotels.com/”,
“snippet_count”: 1,
“url”: “https://www.hotels.com/”
},

}
}
]

Параметры ответа

ИмяОписание
domainДомен
ads_countКоличество объявлений
keywords_countКоличество запросов
traffic_sumТрафик
price_sumБюджет
snippetsСписок рекламных объявлений домена
snippet_numНомер объявления
snippets_countКоличество объявлений
snippet_titleЗаголовок
snippet_descriptionТекст объявления
snippet_display_urlОтображаемый URL
urlСсылка

Ошибки

HTTP-кодСообщение об ошибке
400Invalid domain
400Invalid source
400Row limit exceeded

Платные объявления по домену

Описание

Метод позволяет получить обзор платных объявлений по домену.

Формат запроса

GET https://api4.seranking.com/research/{source}/advertising/?domain=booking.com

Параметры в запросе

ИмяОбязательныйОписание
domainДаДомен
fromНетГод и месяц начала периода (2017-01)
toНетГод и месяц окончания периода (2018-12)
pageНетСтраница результатов (по умолчанию – 1)
limitНетКоличество элементов (по умолчанию – 100, максимум 1000)

Результат

В случае успеха сервер возвращает обзор платных объявлений по домену.

Пример

[{
“keyword”:”locanda vivaldi venice”,
“ads_count”:24,
“competition”:0.39,
“cpc”:5.64,
“volume”:100,
“traffic”:47.9,
“traffic_percent”:0.51,
“snippets”:
{
2017-01:
{
“position”:2,
“snippet_title”:”Locanda Vivaldi, Venice – Booking.com‎”,
“snippet_description”:”Book at Locanda Vivaldi, Venice. No reservation costs. Great rates Amenities: Free Wifi, Non Smoking Rooms, 24 Hour Front Desk, Air Conditioning”,
“snippet_display_url”:”www.booking.com/hotel/it/locanda-vivaldi.en.html?a”,
“snippet_count”:1,
“url”:”http://www.booking.com/hotel/it/locanda-vivaldi.en.html?aid=311088″
},
,

]

Параметры ответа

ИмяОписание
keywordКлючевое слово
ads_countОбщее количество объявлений
competitionКонкуренция
cpcCPC
volumeЧастотность
trafficТрафик
traffic_percentДоля трафика
snippetsСписок рекламных объявлений домена
snippets_countКоличество объявлений
snippet_titleЗаголовок
snippet_descriptionТекст объявления
snippet_display_urlОтображаемый URL
urlСсылка

Ошибки

HTTP-кодСообщение об ошибке
400Row limit exceeded
400Invalid keyword
400Invalid source

Конкуренты

Описание

Метод позволяет получить список доменов конкурентов (максимум 500).

Формат запроса

GET https://api4.seranking.com/research/{source}/competitors?domain=booking.com&type=adv

Параметры в запросе

ИмяОбязательныйОписание
domainДаДомен
typeНетorganic – данные по органическому трафику (по умолчанию)
adv – данные по платному трафику
big_playersНет0 – скрыть крупных игроков (по умолчанию)
1 – показать крупных игроков
statsНет0 – только список доменов и количество общих ключевых слов (по умолчанию)
1 – вывод доп. параметров

Результат

В случае успеха сервер возвращает список доменов конкурентов.

Пример

[
{
“domain”: “tripadvisor.ru”,
“common_keywords”: 1076
},

]

..stats=1

[
{
“domain”: “tripadvisor.ru”,
“common_keywords”: 1076,
“total_keywords”: 2084,
“missing_keywords”:5450,
“traffic_sum”: 291,
“price_sum”: 40.12,
},

]

Параметры ответа

ИмяОписание
domainДомен конкурента
common_keywordsКлючевые слова, используемые как анализируемым сайтом, так и его конкурентами
total_keywordsОбщее число ключевых слов, по которым конкуренты находятся в ТОП-100 Google
missing_keywordsКлючевые слова, по которым конкуренты находятся в ТОП-100 Google, а анализируемый сайт имеет очень низкую или нулевую видимость
traffic_sumПредполагаемый объем трафика для сайта с существующими ключевыми словами. Рассчитывается с использованием формулы ожидаемого CTR (сlick-through rate – соотношение кликов к показам), частотности и текущих позиций
price_sumПредполагаемая месячная стоимость выбранных рекламных объявлений с учетом числа ключевых слов, их цены и трафика

Ошибки

HTTP-кодСообщение об ошибке
400Invalid domain
400Invalid source

Сравнение доменов

Описание

Метод позволяет получить список ключевых слов для 2 доменов.

Формат запроса

GET https://api4.seranking.com/research/{source}/competitors/compare?domain=booking.com&compare=google.com&type=adv

Параметры запроса

ИмяОбязательныйОписание
domainДаДомен
compareДаДомен конкурента
typeНетorganic – данные по органическому трафику (по умолчанию)adv – данные по платному трафику
pageНетСтраница результатов (по умолчанию – 1)
limitНетКоличество элементов (по умолчанию – 100, максимум 1000)
colsНетСписок возвращаемых значений (через запятую)
diffНет0 – общие ключевые слова доменов domain и compare (по умолчанию)
1 – ключевые слова домена compare, которых нет у domain

Результат

В случае успеха сервер возвращает список ключевых слов для 2 доменов.

Пример

[
{
“keyword”: “haworth hotel holland mi”,
“volume”: 10,
“cpc”: 3.01,
“competition”: 0.38,
“difficulty”: 5,
“total_sites”: 94,
“position”: 4,
“url”: “https://www.booking.com/hotel/us/haworth-inn-center.html”,
“price”: 2.44,
“traffic”: 0.81,
“compare_position”: 5,
“compare_url”: “https://www.hotels.com/ho576868/haworth/”,
“compare_price”: 1.84,
“compare_traffic”: 0.61
},

]

Параметры ответа

ИмяОписание
keywordАнализируемое ключевое слово
competitionКонкуренция
difficultyСложность ключевого слова
cpcCPC (Cost per click) – стоимость одного клика
volumeМесячное количество обращений по данному ключевому слову к поиску Google
total_sitesВсего сайтов по запросу
positionПозиция
urlURL страницы, которая ранжируется в Google по указанному ключевому слову
priceСтоимость
trafficTraffic
priceСтоимость
compare_positionПозиция сравниваемого домена
compare_urlURL страницы сравниваемого домена
compare_priceСтоимость трафика для сравниваемого домена
compare_trafficТрафик сравниваемого домена

Ошибки

HTTP-кодСообщение об ошибке
400Invalid domain
400Invalid source