nofollow

Анализ конкуренции в SEO/PPC

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

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

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

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

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

Описание

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

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

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

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

ИмяОбязательныеОписание
domainДаДомен

Результат

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

Пример

[
  {
   «source»: «us»,
   «year_month»: «2018-10»,
   «organic»: {
     «count»: 790,
     «traffic»: 3149,
     «cost»: 23167.97
   },
   «adv»: {
     «count»: 140,
     «traffic»: 2968,
     «cost»: 17795.26
   }
  },
…
]

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

ИмяОписание
sourceБаза, к которой производится запрос
year_month Год и месяц данных в базе
organicДанные по органическому трафику
avdДанные по платному трафику
keywords_count Количество ключевых слов
traffic_sumПрогноз трафика
price_sumОценка стоимости

Ошибки

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

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

Описание

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

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

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

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

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

Результат

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

Пример

{
    «organic»: {
        «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,
        «count»: 790,
        «traffic»: 3149,
        «cost»: 23167.97
    },
    «adv»: {
        «keywords_new_count»: 91,
        «keywords_up_count»: 17,
        «keywords_equal_count»: 18,
        «keywords_lost_count»: 62,
        «top11_20»: 0,
        «top1_2»: 53,
        «top51_100»: 0,
        «keywords_down_count»: 76,
        «top1_5»: 121,
        «top21_50»: 0,
        «top3_5»: 68,
        «top6_8»: 19,
        «top9_11»: 0,
        «top6_10»: 19,
            «count»: 140,
            «traffic»: 2968,
            «cost»: 17795.26
    }
}

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

ИмяОписание
organicДанные по органическому трафику
avdДанные по платному трафику
keywords_countКоличество ключевых слов
traffic_sumПрогноз трафика
price_sumОценка стоимости
top1_5
Количество ключевых слов с позициями 1-5
top6_10
Количество ключевых слов с позициями 6-10
top-11-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Падение позиций

Ошибки

HTTP-кодСообщение об ошибке
400Invalid domain
404Invalid 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
top-21-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/»,
    kei: 1.136,
    total_sites: 88,
    traffic: 3,
    traffic_percent: «11.11%»,
    price: 0
},
…
]

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

ИмяОписание
keywordКлючевое слово
positionПозиция
prev_posПозиция в предыдущем месяце
volumeЧастотность
cpcCPC
competitionКонкуренция
urlURL
keiKEI
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»,
«kei»: 355.464,
«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»
},
…
]

Параметры

block top | 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, максимум 100)

Результат

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

Пример

[
    {
    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, максимум 100)

Результат

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

Пример

[{
 keyword: «locanda vivaldi venice»,
    ads_count: 24,
    competition: «0.39»,
    cpc: «5.64»,
    volume: «100»,
    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»,
            snippet_num: 125,
            url: «http://www.booking.com/hotel/it/locanda-vivaldi.en.html?aid=311088»
        },
,
…
]

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

ИмяОписание
keywordКлючевое слово
ads_countОбщее количество объявлений
competitionКонкуренция
cpcCPC
volumeЧастотность
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.com»,
«common_keywords»: 1076},
…
]

..stats=1

[
 {
  «domain»: «tripadvisor.com»,
  «common_keywords»: 1076,
  «total_keywords»: 2084,
  «traffic_sum»: 291,
  «price_sum»: 40.12,
},
…
]

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

ИмяОписание
domainДомен
common_keywords Ключевые слова, используемые как анализируемым сайтом, так и его конкурентами
total_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»,
   «kei»: 1.064,
   «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Анализируемое ключевое слово
keiKEI (Keyword Effectiveness Index) — индекс эффективности ключевого слова
competitionКонкуренция
cpcCPC (Cost per click) – стоимость одного клика
volume Месячное количество обращений по данному ключевому слову к поиску Google
total_sitesВсего сайтов по запросу
positionПозиция
urlURL страницы, которая ранжируется в Google по указанному ключевому слову
priceСтоимость
trafficTraffic
priceСтоимость
compare_positionПозиция сравниваемого домена
compare_url URL страницы сравниваемого домена
compare_price Стоимость трафика для сравниваемого домена
compare_traffic Трафик сравниваемого домена

Ошибки

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