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

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

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

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

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

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

Описание

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

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

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

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

Имя	Обязательный	Описание
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,

        «keywords_count»: 790,

        «traffic_sum»: 3149,

        «price_sum»: 23167.97

    },

    «adv»: {

        «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

    }

}

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

Имя	Описание
organic	Данные по органическому трафику
avd	Данные по платному трафику
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	Падение позиций

Ошибки

HTTP-код	Сообщение об ошибке
400	Invalid domain
400	Invalid 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-код	Сообщение об ошибке
400	Invalid domain
404	Invalid 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	Частотность
cpc	CPC
competition	Конкуренция
url	URL
kei	KEI
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-код	Сообщение об ошибке
400	Invalid domain
400	Invalid source
400	Incorrect order
400	Row 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-код	Сообщение об ошибке
400	Invalid domain
400	Invalid source
400	Row 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»,

        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: «https://www.booking.com/hotel/it/locanda-vivaldi.en.html?aid=311088»

                    },

                    …

]

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

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

Ошибки

HTTP-код	Сообщение об ошибке
400	Row limit exceeded
400	Invalid keyword
400	Invalid 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,

    «traffic_sum»: 291,

    «price_sum»: 40.12,

},

…

]

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

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

Ошибки

HTTP-код	Сообщение об ошибке
400	Invalid domain
400	Invalid 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	Анализируемое ключевое слово
kei	KEI (Keyword Effectiveness Index) — индекс эффективности ключевого слова
competition	Конкуренция
cpc	CPC (Cost per click) – стоимость одного клика
volume	Месячное количество обращений по данному ключевому слову к поиску Google
total_sites	Всего сайтов по запросу
position	Позиция
url	URL страницы, которая ранжируется в Google по указанному ключевому слову
price	Стоимость
traffic	Traffic
price	Стоимость
compare_position	Позиция сравниваемого домена
compare_url	URL страницы сравниваемого домена
compare_price	Стоимость трафика для сравниваемого домена
compare_traffic	Трафик сравниваемого домена

Ошибки

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

Содержание

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

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

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

Описание

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

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

Результат

Пример

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

Ошибки

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

Описание

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

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

Результат

Пример

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

Ошибки

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

Описание

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

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

Результат

Пример

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

Пример

Параметры

Ошибки

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

Описание

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

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

Результат

Пример

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

Ошибки

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

Описание

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

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

Результат

Пример

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

Ошибки

Конкуренты

Описание

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

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

Результат

Пример

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

Ошибки

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

Описание

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

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

Результат

Пример

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

Ошибки