Коннектор для работы с API Топвизор - сервисом мониторинга позиций сайта в поисковых системах
Поля, которые доступны в рамках выбранного отчета.
Возвращает общую статистику по всем проектам пользователя с данными о позициях, видимости и динамике
| Поле | Название | Тип | Описание |
|---|---|---|---|
project_id | ID проекта | String | Идентификатор проекта, используется для указания проекта, с которым должна вестись работа |
project_name | Название проекта | String | Название проекта в системе Топвизор |
project_url | URL проекта | String | URL сайта проекта |
region_index | Индекс региона | Int64 | Индекс региона определяет уникальный набор параметров поисковой системы, ключа региона и языка региона |
region_name | Название региона | String | Название региона поиска |
region_enabled | Статус региона | Int64 | Включен ли регион для мониторинга (True/False) |
searcher_id | ID поисковой системы | String | Ключ поисковой системы, идентифицирующий её в сервисе Топвизор |
searcher_name | Название поисковой системы | String | Название поисковой системы (Яндекс, Google и т.д.) |
searcher_enabled | Статус поисковой системы | Int64 | Включена ли поисковая система для мониторинга (True/False) |
history_sqi | SQI в истории | Float64 | Показатель качества сайта (SQI) из истории |
history_indexed_y | Проиндексированные страницы Яндекс | Float64 | Количество страниц, проиндексированных Яндексом |
history_indexed_g | Проиндексированные страницы Google | Float64 | Количество страниц, проиндексированных Google |
history_traffic_y | Трафик Яндекс | Float64 | Трафик из Яндекса |
history_traffic_g | Трафик Google | Float64 | Трафик из Google |
history_traffic_m | Трафик Mail.ru | Float64 | Трафик из Mail.ru |
history_traffic_5 | Трафик 5 | Float64 | Трафик из поисковой системы с ID 5 |
history_traffic_6 | Трафик 6 | Float64 | Трафик из поисковой системы с ID 6 |
history_backlinks | Обратные ссылки | Float64 | Количество обратных ссылок на сайт |
history_date | Дата истории | Date | Дата данных истории |
dynamics_all | Общая динамика | Int64 | Общее изменение позиций |
dynamics_up | Позиции вверх | Int64 | Количество позиций, которые улучшились |
dynamics_stay | Позиции без изменений | Int64 | Количество позиций без изменений |
dynamics_down | Позиции вниз | Int64 | Количество позиций, которые ухудшились |
top_1_10 | ТОП 1-10 | Int64 | Количество ключевых слов в ТОП 1-10 |
top_11_30 | ТОП 11-30 | Int64 | Количество ключевых слов в ТОП 11-30 |
top_31_50 | ТОП 31-50 | Int64 | Количество ключевых слов в ТОП 31-50 |
top_51_100 | ТОП 51-100 | Int64 | Количество ключевых слов в ТОП 51-100 |
top_101_10000 | ТОП 101-10000 | Int64 | Количество ключевых слов в ТОП 101-10000 |
avg_position | Средняя позиция | Float64 | Средняя позиция по всем ключевым словам |
visibility | Видимость | Float64 | Показатель видимости сайта |
avg_position_dynamic | Динамика средней позиции | Float64 | Изменение средней позиции |
visibility_dynamic | Динамика видимости | Float64 | Изменение показателя видимости |
top_1_10_dynamic | Динамика ТОП 1-10 | Float64 | Изменение количества ключевых слов в ТОП 1-10 |
top_11_30_dynamic | Динамика ТОП 11-30 | Float64 | Изменение количества ключевых слов в ТОП 11-30 |
top_31_50_dynamic | Динамика ТОП 31-50 | Float64 | Изменение количества ключевых слов в ТОП 31-50 |
top_51_100_dynamic | Динамика ТОП 51-100 | Float64 | Изменение количества ключевых слов в ТОП 51-100 |
top_101_10000_dynamic | Динамика ТОП 101-10000 | Float64 | Изменение количества ключевых слов в ТОП 101-10000 |
top_1_3 | ТОП 1-3 | Int64 | Количество ключевых слов в ТОП 1-3 |
top_1_3_dynamic | Динамика ТОП 1-3 | Float64 | Изменение количества ключевых слов в ТОП 1-3 |
smd_task_id | ID задачи | Int32 | Идентификатор задачи в системе (Техническое поле StreamMyData) |
smd_source_date | Дата источника | Date | Дата в источнике данных (Техническое поле StreamMyData) |
Предоставляет детальную историю позиций всех ключевых слов проекта за указанный период
| Поле | Название | Тип | Описание |
|---|---|---|---|
keyword_id | ID ключевого слова | String | Уникальный идентификатор ключевого слова |
keyword_name | Ключевое слово | String | Текст ключевого слова |
group_id | ID группы | String | Идентификатор группы ключевых слов |
date | Дата | Date | Дата проверки позиции |
project_id | ID проекта | String | Идентификатор проекта, используется для указания проекта, с которым должна вестись работа |
region_index | Индекс региона | Int64 | Индекс региона определяет уникальный набор параметров поисковой системы, ключа региона и языка региона |
position | Позиция | Int64 | Позиция ключевого слова в выдаче |
snippet | Сниппет | String | Текст сниппета в результатах поиска |
relevant_url | Релевантный URL | String | URL страницы, которая ранжируется по данному запросу |
visitors | Посетители | Int64 | Количество посетителей по данному ключевому слову |
group_name | Название группы | String | Название группы ключевых слов |
region_name | Название региона | String | Название региона поиска |
smd_task_id | ID задачи | Int32 | Идентификатор задачи в системе (Техническое поле StreamMyData) |
smd_source_date | Дата источника | Date | Дата в источнике данных (Техническое поле StreamMyData) |
Агрегированная сводная информация о позициях проекта по регионам за выбранный период с динамикой изменений
| Поле | Название | Тип | Описание |
|---|---|---|---|
date | Дата | Date | Дата сводки |
region_name | Название региона | String | Название региона поиска |
avg_position | Средняя позиция | Float64 | Средняя позиция по всем ключевым словам |
median_position | Медианная позиция | Int64 | Медианная позиция по всем ключевым словам |
visibility | Видимость | Float64 | Показатель видимости сайта |
top_1_3 | ТОП 1-3 | Int64 | Количество ключевых слов в ТОП 1-3 |
top_1_10 | ТОП 1-10 | Int64 | Количество ключевых слов в ТОП 1-10 |
top_11_30 | ТОП 11-30 | Int64 | Количество ключевых слов в ТОП 11-30 |
top_31_50 | ТОП 31-50 | Int64 | Количество ключевых слов в ТОП 31-50 |
top_51_100 | ТОП 51-100 | Int64 | Количество ключевых слов в ТОП 51-100 |
top_101_10000 | ТОП 101-10000 | Int64 | Количество ключевых слов в ТОП 101-10000 |
avg_dynamic | Средняя динамика | Float64 | Средняя динамика изменения позиций |
median_dynamic | Медианная динамика | Float64 | Медианная динамика изменения позиций |
visibility_dynamic | Динамика видимости | Float64 | Изменение показателя видимости |
total_keywords | Всего ключевых слов | Int64 | Общее количество отслеживаемых ключевых слов |
keywords_up | Ключевые слова вверх | Float64 | Количество ключевых слов, которые улучшили позиции |
keywords_stay | Ключевые слова без изменений | Float64 | Количество ключевых слов без изменения позиций |
keywords_down | Ключевые слова вниз | Float64 | Количество ключевых слов, которые ухудшили позиции |
top_1_3_dynamic | Динамика ТОП 1-3 | Float64 | Изменение количества ключевых слов в ТОП 1-3 |
top_1_10_dynamic | Динамика ТОП 1-10 | Float64 | Изменение количества ключевых слов в ТОП 1-10 |
top_11_30_dynamic | Динамика ТОП 11-30 | Float64 | Изменение количества ключевых слов в ТОП 11-30 |
top_31_50_dynamic | Динамика ТОП 31-50 | Float64 | Изменение количества ключевых слов в ТОП 31-50 |
top_51_100_dynamic | Динамика ТОП 51-100 | Float64 | Изменение количества ключевых слов в ТОП 51-100 |
top_101_10000_dynamic | Динамика ТОП 101-10000 | Float64 | Изменение количества ключевых слов в ТОП 101-10000 |
region_index | Индекс региона | Int64 | Индекс региона определяет уникальный набор параметров поисковой системы, ключа региона и языка региона |
smd_task_id | ID задачи | Int32 | Идентификатор задачи в системе (Техническое поле StreamMyData) |
smd_source_date | Дата источника | Date | Дата в источнике данных (Техническое поле StreamMyData) |
Видимость по группам ключевых слов только для выбранного проекта
| Поле | Название | Тип | Описание |
|---|---|---|---|
date | Дата | Date | Дата |
visibility | Видимость | Float64 | Показатель видимости |
group_id | ID группы | String | Идентификатор группы |
group_name | Группа | String | Название группы ключевых слов |
searcher_name | Поисковая система | String | Название поисковой системы |
project_id | ID проекта | String | Идентификатор проекта |
region_index | Индекс региона | Int64 | Индекс региона |
region_name | Название региона | String | Название региона |
smd_task_id | ID задачи | Int32 | Техническое поле StreamMyData |
smd_source_date | Дата источника | Date | Техническое поле StreamMyData |
Сводка позиций по регионам за период с разбивкой по основному проекту и его конкурентам. К каждой строке добавляется колонка main_project_or_competitor
| Поле | Название | Тип | Описание |
|---|---|---|---|
date | Дата | Date | Дата сводки |
region_name | Название региона | String | Название региона поиска |
avg_position | Средняя позиция | Float64 | Средняя позиция по всем ключевым словам |
median_position | Медианная позиция | Int64 | Медианная позиция по всем ключевым словам |
visibility | Видимость | Float64 | Показатель видимости сайта |
top_1_3 | ТОП 1-3 | Int64 | Количество ключевых слов в ТОП 1-3 |
top_1_10 | ТОП 1-10 | Int64 | Количество ключевых слов в ТОП 1-10 |
top_11_30 | ТОП 11-30 | Int64 | Количество ключевых слов в ТОП 11-30 |
top_31_50 | ТОП 31-50 | Int64 | Количество ключевых слов в ТОП 31-50 |
top_51_100 | ТОП 51-100 | Int64 | Количество ключевых слов в ТОП 51-100 |
top_101_10000 | ТОП 101-10000 | Int64 | Количество ключевых слов в ТОП 101-10000 |
avg_dynamic | Средняя динамика | Float64 | Средняя динамика изменения позиций |
median_dynamic | Медианная динамика | Float64 | Медианная динамика изменения позиций |
visibility_dynamic | Динамика видимости | Float64 | Изменение показателя видимости |
total_keywords | Всего ключевых слов | Int64 | Общее количество отслеживаемых ключевых слов |
keywords_up | Ключевые слова вверх | Float64 | Количество ключевых слов, которые улучшили позиции |
keywords_stay | Ключевые слова без изменений | Float64 | Количество ключевых слов без изменения позиций |
keywords_down | Ключевые слова вниз | Float64 | Количество ключевых слов, которые ухудшили позиции |
top_1_3_dynamic | Динамика ТОП 1-3 | Float64 | Изменение количества ключевых слов в ТОП 1-3 |
top_1_10_dynamic | Динамика ТОП 1-10 | Float64 | Изменение количества ключевых слов в ТОП 1-10 |
top_11_30_dynamic | Динамика ТОП 11-30 | Float64 | Изменение количества ключевых слов в ТОП 11-30 |
top_31_50_dynamic | Динамика ТОП 31-50 | Float64 | Изменение количества ключевых слов в ТОП 31-50 |
top_51_100_dynamic | Динамика ТОП 51-100 | Float64 | Изменение количества ключевых слов в ТОП 51-100 |
top_101_10000_dynamic | Динамика ТОП 101-10000 | Float64 | Изменение количества ключевых слов в ТОП 101-10000 |
region_index | Индекс региона | Int64 | Индекс региона определяет уникальный набор параметров поисковой системы, ключа региона и языка региона |
smd_task_id | ID задачи | Int32 | Идентификатор задачи в системе (Техническое поле StreamMyData) |
smd_source_date | Дата источника | Date | Дата в источнике данных (Техническое поле StreamMyData) |
main_project_or_competitor | Домен/конкурент | String | Домен основного проекта либо имя конкурента |
Видимость по группам ключевых слов с разбивкой по основному проекту и его конкурентам. К каждой строке добавляется колонка main_project_or_competitor
| Поле | Название | Тип | Описание |
|---|---|---|---|
date | Дата | Date | Дата |
visibility | Видимость | Float64 | Показатель видимости |
group_id | ID группы | String | Идентификатор группы |
group_name | Группа | String | Название группы ключевых слов |
searcher_name | Поисковая система | String | Название поисковой системы |
project_id | ID проекта | String | Идентификатор проекта |
region_index | Индекс региона | Int64 | Индекс региона |
region_name | Название региона | String | Название региона |
smd_task_id | ID задачи | Int32 | Техническое поле StreamMyData |
smd_source_date | Дата источника | Date | Техническое поле StreamMyData |
main_project_or_competitor | Домен/конкурент | String | Домен основного проекта либо имя конкурента |