Содержание
体育平台app
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”: {
“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-код | Сообщение об ошибке |
| 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/”,
“total_sites”: 88,
“traffic”: 3,
“traffic_percent”: 11.11,
“price”: 0
},
…
]
Параметры ответа
| Имя | Описание |
| keyword | Ключевое слово |
| position | Позиция |
| prev_pos | Позиция в предыдущем месяце |
| volume | Частотность |
| cpc | CPC |
| competition | Конкуренция |
| url | URL |
| 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”
},
…
]
Параметры
| 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,
“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 | Конкуренция |
| cpc | CPC |
| volume | Частотность |
| traffic | Трафик |
| traffic_percent | Доля трафика |
| 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,
“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-код | Сообщение об ошибке |
| 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,
“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 | Сложность ключевого слова |
| 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 |