Измените языковые настройки Топвизор для работы с сервисом на родном языке. Вы также сможете выбрать и установить язык интерфейса позже в настройках Аккаунта. Измените языковые настройки Топвизор для работы с сервисом на родном языке. ru Русский Выбрать

get/positions_2/history

Описание метода

Получает историю проверки позиций.

Метод не работает с архивными проектами.

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

Параметр Тип Описание По умолчанию
Обязательные
project_id int ID проекта
regions_indexes array(int) Индексы регионов
dates array of date Произвольные даты проверок
(dates является обязательным, если date1 и date2 не указаны)
date1, date2 date Крайние даты периода
(date1 и date2 являются обязательным, если dates не указан)
Дополнительные
fields array fields
of keywords
Возвращаемые поля объекта "Ключевая фраза"
competitors_ids array(int) ID конкурентов (или ID проекта), добавленных в настройках проекта
type_range enum(0, 1, 2, 3, 4, 5, 6, 7, 100)

Период дат

Возможные значения:

  • 0 - весь период без ограничений
  • 1 - только апдейты
  • 2 - период до 31 даты
  • 3 - две даты
  • 4 - одна дата
  • 5 - последняя дата каждого месяца
  • 6 - даты через равные промежутки
  • 7 - две последние даты проверок
  • 100 - произвольные даты (иcпользуется только с параметром dates)
2
count_dates int Максмальное число возвращаемых дат (не более 31)
only_exists_first_date boolean Отображать только ключевые фразы, присутствующие в первой проверке указанного периода
show_headers boolean Добавить в результат заголовки результатов 0
show_exists_dates boolean Добавить в результат даты, в которых были проверки 0
show_visitors boolean Добавить в результат данные об общем количество визитов по каждой проверке 0
show_top_by_depth int Добавить в результат данные по ТОПу указанной глубины по каждой проверке 0
positions_fields array('position', 'snippet', 'relevant_url', 'visitors')

Выбор столбцов данных с результатами проверки:

  • position - позиция запроса
  • snippet - сниппет
  • relevant_url - релевантная страница
  • visitors - количество визитов
filter_by_dynamic set('>', '<', '=') Фильтр по ключевым фразам, позиции которых поднялись/упали/не изменились за крайние даты периода
* работает при получении позиций по одному проекту, одному региону для более чем одной даты
filter_by_positions array of array(int, int) Фильтр по ключевым фразам, позиции которых входят в указанные промежутки

Посмотреть в API Explorer

Возвращаемые данные

Параметр Тип Описание
result (объект)
keywords array of keywords Отчет по ключевым словам и другие поля ключевых фраз
keywords.positionsData object(определитель => object) Данные по проверке
headers array Заголовки результатов (если show_headers = 1)
existsDates array(date) Даты, в которых были проверки (если show_exists_dates = 1)
visitors object(определитель => object) Данные об общем количество визитов по каждой проверке (если show_visitors = 1)
tops object(определитель => object) Данные по ТОПу указанной глубины по каждой проверке (если show_top_by_depth = N)
result.keywords[N].positionsData[date:projectId:regionIndex]
position int или string('--') Позиция запроса
relevant_url string Релевантная страница
visitors int Количество визитов
result.headers (если show_headers = 1)
fieldsLabels array Объекты заголовков запрошенных полей (параметр fields)
positionsFields array Соотвтетсвует входному параметру positions_fields
dates array Даты проверок, вошедших в отчет
projects array Проекты (конкуренты) с их поисковыми системами и регоинами
result.visitors (если show_visitors = 1)
%Y-d-m:project_id:region_index% int Количество визитов по определителю
result.tops (если show_top_by_depth = N)
%Y-d-m:project_id:region_index% int Процент ключевых фраз в ТОП-N по определителю