Содержание
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 |