Трансформируем ваши данные в прибыль
Коннектор для работы с REST API сервиса Keys.so. Позволяет выгружать данные по конкурентам в органической выдаче, помесячную историю позиций домена и данные по упоминаниям в ИИ-ответах Яндекс Алисы. Авторизация — токен из личного кабинета Keys.so (блок «REST API»), доступен на тарифах «Профессиональный» и «Корпоративный».
Поля, которые доступны в рамках выбранного отчета.
Сводные метрики домена на момент выгрузки: количество запросов в топ-1/3/5/10/50, оценка трафика из органики и контекста, число страниц в индексе, оценки рекламного бюджета и количество упоминаний в ИИ-ответах Яндекс Алисы. Одна строка на домен. Данные являются снимком на дату выгрузки: API Keys.so не поддерживает запрос за прошедшие даты.
| Поле | Название | Тип | Описание |
|---|---|---|---|
domain | Домен | String | Домен, по которому запрошен отчёт |
base | База | String | Региональная база выдачи, из которой взяты данные |
id | ID домена | Int64 | Внутренний идентификатор домена в базе Keys.so |
name | Название домена | String | Имя домена по данным Keys.so |
dr | Рейтинг домена | Int32 | Domain Rating — оценка авторитетности домена |
parentid | ID родительского домена | Int64 | Идентификатор основного домена, если это поддомен |
parentName | Родительский домен | String | Имя основного домена, если это поддомен |
childsCount | Количество поддоменов | Int32 | Сколько поддоменов найдено у сайта |
it1 | Запросов в топ-1 | Int64 | Количество запросов, по которым домен на первой позиции |
it3 | Запросов в топ-3 | Int64 | Количество запросов в первой тройке выдачи |
it5 | Запросов в топ-5 | Int64 | Количество запросов в первой пятёрке выдачи |
it10 | Запросов в топ-10 | Int64 | Количество запросов в первой десятке выдачи |
it50 | Запросов в топ-50 | Int64 | Количество запросов в первых пятидесяти позициях |
restop5 | Доля топ-5 от топ-50 | Int32 | Процент запросов из топ-50, занимающих позиции в топ-5 |
topvis | Место по видимости | Int32 | Позиция домена в рейтинге Keys.so по видимости |
topkeys | Место по охвату ключей | Int32 | Позиция домена в рейтинге Keys.so по числу ключевых фраз |
pagesinindex | Страниц в выдаче | Int64 | Сколько страниц сайта найдено в поисковом индексе |
vis | Трафик из органики | Int64 | Оценка числа пользователей из органического поиска в сутки |
adtraf | Трафик из контекста | Int64 | Оценка трафика из контекстной рекламы без учёта таргетингов: точная частотность на прогноз CTR, делённые на 30 дней |
adscnt | Объявлений в контексте | Int64 | Количество найденных рекламных объявлений домена |
adkeyscnt | Запросов в контексте | Int64 | Количество запросов, по которым домен рекламируется |
adcost_average | Оценка бюджета, средняя | Int64 | Средняя оценка рекламного бюджета домена в контексте |
adcost_max | Оценка бюджета, максимальная | Int64 | Максимальная оценка рекламного бюджета |
adcost_bdg100 | Оценка бюджета, 100% показов | Int64 | Оценка бюджета при выкупе 100% показов |
adcost_bdg85 | Оценка бюджета, 85% показов | Int64 | Оценка бюджета при выкупе 85% показов |
adcost_bdg62 | Оценка бюджета, 62% показов | Int64 | Оценка бюджета при выкупе 62% показов |
adcost_bdg9 | Оценка бюджета, 9% показов | Int64 | Оценка бюджета при выкупе 9% показов |
adcost_bdg5 | Оценка бюджета, 5% показов | Int64 | Оценка бюджета при выкупе 5% показов |
aiAnswersCnt | Упоминаний в ИИ-ответах | Int64 | Сколько раз домен упомянут в ИИ-ответах Яндекс Алисы за последние 30 дней. Численно совпадает с полем aiCnt последнего месяца в отчёте «История домена по месяцам» |
aiState | Статус ИИ-отчёта | Int32 | Технический код состояния ИИ-отчёта на стороне Keys.so: 0 — не создан, 10 — ожидает построения, 20 — строится, 30 — ошибка, 40 — готов |
iconUrl | Иконка домена | String | Ссылка на favicon домена в хранилище Keys.so |
Помесячная динамика метрик домена: позиции в топах, страницы в индексе, реклама, трафик и упоминания в ИИ-ответах Яндекс Алисы. Одна строка на месяц. API отдаёт 18 последних месяцев скользящим окном — при каждой выгрузке самый старый месяц выпадает, а данные текущего месяца ещё не закрыты и меняются, поэтому отчёт перезагружается целиком.
| Поле | Название | Тип | Описание |
|---|---|---|---|
domain | Домен | String | Домен, по которому запрошен отчёт |
base | База | String | Региональная база выдачи, из которой взяты данные |
report_month | Месяц | String | Месяц снимка в формате ГГГГ.ММ, например 2026.08 |
report_month_date | Дата месяца | Date | Тот же месяц в виде даты первого числа — для построения графиков без дополнительного преобразования |
it1 | Запросов в топ-1 | Int64 | Количество запросов на первой позиции в этом месяце |
it3 | Запросов в топ-3 | Int64 | Количество запросов в первой тройке в этом месяце |
it5 | Запросов в топ-5 | Int64 | Количество запросов в первой пятёрке в этом месяце |
it10 | Запросов в топ-10 | Int64 | Количество запросов в первой десятке в этом месяце |
it50 | Запросов в топ-50 | Int64 | Количество запросов в топ-50 в этом месяце |
pagesInIndex | Страниц в индексе | Int64 | Число страниц сайта в поисковом индексе в этом месяце |
adsCount | Объявлений в контексте | Int64 | Количество рекламных объявлений домена в этом месяце |
adKeysCount | Запросов в контексте | Int64 | Количество рекламных запросов домена в этом месяце |
visAvg | Средний трафик | Int64 | Усреднённая оценка трафика из поиска за этот месяц |
aiCnt | Упоминаний в ИИ-ответах | Int64 | Сколько раз домен упомянут в ИИ-ответах Яндекс Алисы за этот месяц. Данные доступны с августа 2025 года, в более ранних месяцах значение равно нулю |
Домены, которые встречаются в органической выдаче по тем же запросам, что и анализируемый домен. Для каждого конкурента доступны число общих запросов, похожесть, тематичность, собственные позиции в топах и показатели рекламы. Одна строка на конкурента. Данные являются снимком на дату выгрузки.
| Поле | Название | Тип | Описание |
|---|---|---|---|
domain | Домен | String | Анализируемый домен, для которого искались конкуренты |
base | База | String | Региональная база выдачи, из которой взяты данные |
id | ID конкурента | Int64 | Внутренний идентификатор домена-конкурента в Keys.so |
name | Домен конкурента | String | Имя домена-конкурента |
cnt | Общих запросов | Int64 | Количество запросов из топ-50, по которым в выдаче присутствуют и анализируемый домен, и конкурент |
perc | Похожесть, % | Float64 | Доля общих запросов от всех запросов конкурента — насколько конкурент похож на анализируемый домен |
theme | Тематичность, % | Float64 | Доля запросов анализируемого домена, присутствующих у конкурента |
it1 | Запросов конкурента в топ-1 | Int64 | Количество запросов конкурента на первой позиции |
it3 | Запросов конкурента в топ-3 | Int64 | Количество запросов конкурента в первой тройке |
it5 | Запросов конкурента в топ-5 | Int64 | Количество запросов конкурента в первой пятёрке |
it10 | Запросов конкурента в топ-10 | Int64 | Количество запросов конкурента в первой десятке |
it50 | Запросов конкурента в топ-50 | Int64 | Количество запросов конкурента в топ-50 |
pagesinindex | Страниц конкурента в выдаче | Int64 | Число страниц конкурента, найденных в поисковом индексе |
vis | Трафик конкурента | Int64 | Оценка трафика конкурента из органического поиска в сутки |
adscnt | Объявлений конкурента | Int64 | Количество рекламных объявлений конкурента в контексте |
adkeyscnt | Рекламных запросов конкурента | Int64 | Количество запросов, по которым конкурент рекламируется |
adtraf | Трафик конкурента из контекста | Int64 | Оценка трафика конкурента из контекстной рекламы |
adcost | Оценка бюджета конкурента | Int64 | Оценка рекламного бюджета конкурента в контексте |
Домены, которые попадают в ИИ-ответы Яндекс Алисы по тем же запросам, что и анализируемый домен. Для каждого конкурента доступны число общих запросов, похожесть, тематичность и собственные показатели видимости. Одна строка на конкурента. Отчёт доступен только по базе Яндекс Москва. У крупных доменов конкурентов бывает более 400 тысяч, поэтому выгружается топ-N по числу общих запросов — размер задаётся параметром. Если отчёт по ИИ-конкурентам на стороне Keys.so ещё строится, задача будет автоматически повторена позже.
| Поле | Название | Тип | Описание |
|---|---|---|---|
domain | Домен | String | Анализируемый домен, для которого искались конкуренты |
base | База | String | Региональная база. Для этого отчёта всегда Яндекс Москва |
id | ID конкурента | Int64 | Внутренний идентификатор домена-конкурента в Keys.so |
name | Домен конкурента | String | Имя домена-конкурента |
cnt | Общих запросов в ИИ-ответах | Int64 | Количество запросов, по которым в ИИ-ответах Яндекс Алисы упомянуты и анализируемый домен, и конкурент |
perc | Похожесть, % | Float64 | Доля общих запросов от всех запросов конкурента в ИИ-ответах за последний месяц |
theme | Тематичность, % | Float64 | Доля общих запросов от всех запросов анализируемого домена в ИИ-ответах за последние 30 дней |
queries_in_ai_answers | Всего запросов конкурента в ИИ-ответах | Int64 | Общее количество упоминаний конкурента в ИИ-ответах за последний месяц |
it5 | Запросов конкурента в топ-5 | Int64 | Количество запросов конкурента в первой пятёрке органики |
it10 | Запросов конкурента в топ-10 | Int64 | Количество запросов конкурента в первой десятке органики |
it50 | Запросов конкурента в топ-50 | Int64 | Количество запросов конкурента в топ-50 органики |
vis | Трафик конкурента | Int64 | Оценка трафика конкурента из органического поиска в сутки |
Остатки лимитов аккаунта Keys.so на момент выгрузки: сколько доменов в сутки доступно для анализа, сколько запросов к API израсходовано, ограничения по инструментам и размеру отчётов. Отчёт нужен для контроля расхода квот: лимит на анализ доменов считает уникальные домены за сутки, а повторные обращения к тому же домену не расходуются. Не требует указания домена и не тратит доменную квоту.
| Поле | Название | Тип | Описание |
|---|---|---|---|
tool | Инструмент | String | Раздел Keys.so, к которому относится лимит: `analysis` — анализ доменов, `apiRequest` — запросы к API, `wordstat`, `clustering` и другие |
metric | Метрика | String | Полное имя лимита, например `analysis.usedLimit` или `searchKeys.perDay.limit` |
kind | Тип значения | String | Что именно за число: `limit` — доступный лимит, `usedLimit` — сколько израсходовано |
value | Значение | Int64 | Числовое значение лимита или расхода |
