positions Позиции запросов проекта
Метод positions/get отдаёт позиции запросов проекта за один апдейт: по строке на запрос × поисковую систему × регион, с релевантным URL, группами и точной частотой. Без update_id берётся последний завершённый апдейт. Метод синхронный, лимиты не тратит.
- Адрес
/projects/api/v1/positions/get- Доступ
- свои проекты и проекты с выданным доступом
- Лимиты
- не тратит
Позиции за апдейт
/projects/api/v1/positions/get
Позиции отдаются массивом без обёртки status/result. offset и limit считают запросы, а не строки: на каждый запрос приходит по строке на каждую пару «поисковая система + регион» проекта. Какие запросы попадут на страницу, решает сортировка проекта в интерфейсе; внутри страницы строки идут по ID запроса.
Параметры query
-
tokenstring обязательныйКлюч API из настроек аккаунта — тот же, чтоkeyу методов инструментов. -
project_idint обязательныйID проекта. Виден в адресе страницы проекта и в ответе projects/get. -
update_idintID апдейта из updates/get. Без него — последний завершённый апдейт проекта. Апдейт другого проекта даёт пустой массив. -
group_idint -
regionintКод региона: только строки этого региона. Без параметра — все регионы проекта. -
offsetintСколько запросов пропустить. -
limitintСколько запросов отдать.0или без параметра — 1000.
Ответ
-
[].positionstringПозиция;0— сайт не найден в пределах глубины проверки. -
[].idstringID запроса. -
[].querystringФраза. -
[].rel_urlstring|nullРелевантная страница сайта в выдаче. -
[].group_idstringID группы; если групп несколько — через запятую ("1, 22150");"0"— без группы. -
[].group_namestringНазвания групп в том же порядке;Без группы, если групп нет. -
[].update_idstringID апдейта. -
[].search_system_idstringID поисковой системы, как в search-systems/get. -
[].search_system_namestringНазвание поисковой системы. -
[].regionstringКод региона. -
[].region_namestringНазвание региона. -
[].frequencystring|nullТочная частота в регионе частот проекта;null, если не собрана. -
[].deepstring|nullГлубина проверки позиций из настроек проекта.
Ошибки
| Код | Сообщение | Когда |
|---|---|---|
50 |
access error |
Токен не передан, не найден, или у его владельца нет доступа к проекту. |
Пустой ответ
Пустой массив [] приходит, когда у проекта ещё нет апдейтов, update_id чужой, в группе нет запросов или offset больше числа запросов. Ошибки в этих случаях нет.
Как выгрузить все позиции
Возьмите id апдейта из updates/get и запрашивайте страницы с offset = 0, 1000, 2000… с одним и тем же update_id, пока не придёт пустой массив. Без явного update_id страницы могут попасть на разные апдейты, если между вызовами закончится новый.