get/positions_2/history

Индекс региона можно узнать в настройках регионов проекта, используя метод get/projects_2/projects с дополнительным параметром show_searchers_and_regions.
Также region_index можно найти в адресной строке браузера в разделе Проверка позиций или в консоли разработчика.

{
	"limit": 10,
	"show_searchers_and_regions": "1"
}

Добавьте фильтр group_id с id группы запросов или group_folder_id с id папки.

Папки и группы

{
	"limit": 10,
	"project_id": "5046129",
	"regions_indexes": [
		"1"
	],
	"dates": [
		"2024-04-10",
		"2024-04-19"
	],
	"group_id": "28574161"
}

Используйте параметр filter_by_positions, где в массиве укажите крайние позиции в ТОПе для фильтрации. То есть для того, чтобы увидеть позиции в ТОП-10, нужно указать 0:1, 1:10

{
	"limit": 10,
	"project_id": "7357609",
	"regions_indexes": [
		"1"
	],
	"dates": [
		"2024-02-12"
	],
	"filter_by_positions": [
		"1",
		"10"
	]
}

Частота: указать как получаемые данные volume:213:0:1, где параметр - volume, 213 - ключ региона, 0 - ключ ПС, 1 - индекс типа частоты.
Релевантные страницы: параметр positions_fields[] со значением relevant_url
Сниппеты: параметр positions_fields[] со значением snippet

{
	"limit": 10,
	"project_id": "5046129",
	"regions_indexes": [
		"1"
	],
	"dates": [
		"2024-04-10",
		"2024-04-19"
	],
	"fields": [
		"volume:213:0:1"
	],
	"positions_fields": [
		"snippet"
	]
}

Получить все доступные регионы списком возможности нет, однако вы можете осуществить поиск по базе регионов с помощью get/system_2/common/regions

Подробнее о методе

Используйте параметр show_top_by_depth типа int. Процент запросов будет отображаться в конце списка возвращаемых данных.

{
	"limit": 10,
	"project_id": "5046129",
	"regions_indexes": [
		"1"
	],
	"dates": [
		"2024-04-10",
		"2024-04-19"
	],
	"show_top_by_depth": "3"
}

Используйте дополнительный параметр competitors_ids типа массив, в нем укажите id конкурентов, добавленных в настройках проекта.

{
	"limit": 10,
	"project_id": "5046129",
	"regions_indexes": [
		"1"
	],
	"dates": [
		"2024-04-10",
		"2024-04-19"
	],
	"competitors_ids": [
		"5046130",
		"5098972",
		"7471344"
	]
}

Параметр positions_percent получаемых данных в методе projects_2/projects.

{
	"limit": 10,
	"project_id": "5046129",
	"regions_indexes": [
		"1"
	],
	"dates": [
		"2024-04-10",
		"2024-04-19"
	],
	"fields": [
		"positions_percent"
	]
}

Необходимо использовать метод edit/positions_2/checker/go