Апдейт❗Проверки в Яндекс Search API частично возобновлены. Запустить их можно и вручную, и автоматически в период с 20:00 по 05:59 по московскому времени. Для проверок, запущенных между 20:00 и 23:59, данные будут доступны в проектах не ранее полуночи. Как задать расписание проверок →

Чтобы получать данные в другое время, используйте Яндекс SERP, «живую» выдачу Яндекса. Как добавить Яндекс SERP в проект →
    /
  1. add: searchers/regions

add/positions_2/searchers_regions

Добавляет регион в поисковую систему для проверки позиций.

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

Параметр Тип Описание По умолчанию
Обязательные
project_id int ID проекта
searcher_key int

Ключ поисковой системы

Возможные значения параметра см. в методе add/searchers

region_key int

Ключ региона

Для разных поисковых систем список доступных регионов может быть разный.

Дополнительные
region_lang string

Язык интерфейса

Для разных поисковых систем список доступных языков может быть разный.

region_device enum(0, 1, 2)

Тип устройства

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

  • 0 - ПК
  • 1 - планшет
  • 2 - смартфон
0
region_depth int

Глубина проверки

Возможные значения: 1‑3 для Яндекса, 1-10 для Google.

1 соответствует проверке ТОП10 сайтов выдачи для Google и ТОП100 — для Яндекса, 2 — ТОП20 для Google и ТОП200 для Яндекса, 3 — ТОП30 для Google и ТОП250 для Яндекса и т.д.

Проверка мобильной выдачи Яндекса ограничена 50 результатами.

1
region_alt enum('', 'serp', 'html')

Формат выдачи региона (для Яндекса). По умолчанию добавляется XML‑регион (значение — пустая строка). 

''

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