get/positions_2/history

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

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

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

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

{
	"project_id": "5046129",
	"limit": 10,
	"regions_indexes": [
		"1"
	],
	"dates": [
		"2024‑05‑04",
		"2024‑05‑03"
	],
	"filters": [
		{
			"name": "group_id",
			"operator": "EQUALS",
			"values": [
				"28574159"
			]
		}
	]
}

Нет, вы можете получить данные за весь выбранный период без ограничений. Для этого укажите параметр type_range со значением 0:

{
	"project_id": "5046129",
	"regions_indexes": [
		"1"
	],
	"date1": "2024‑01‑01",
	"date2": "2025‑01‑01",
	"type_range": "0",
	"limit":  10
}

Используйте массив filter_by_positions, где укажите крайние позиции в ТОПе для фильтрации. То есть для того, чтобы увидеть позиции в ТОП‑10, нужно указать 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

{
	"project_id": "5046129",
	"limit": 10,
	"regions_indexes": [
		"1"
	],
	"dates": [
		"2024‑05‑04",
		"2024‑05‑03"
	],
	"positions_fields": [
		"relevant_url",
		"snippet"
	],
	"fields": [
		"volume:213:0:1"
	]
}

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

Например, с помощью запроса ниже мы узнаем ID, то есть region key, который можно использовать для добавления региона в проект.

{
	"limit": 10,
	"searcher_key": "1",
	"search": "филад"
}

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

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

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

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

Укажите получаемое поле (field) positions_percent в методе get/projects_2/projects.

{
	"limit": 10,
	"fields": [
		"name",
		"positions_percent"
	]
}

Используйте метод edit/positions_2/checker/go.