Документация API v2. Версия заморожена и продолжает работать; актуальная — на главной. Что изменилось: переход с v2 на v3.
Объекты

Обновить объект

Доступ для AI:

Меняет название объекта и его выключатель. Передавайте только то, что нужно изменить.

Выключенный объект (is_active: false) перестаёт отдавать отзывы и аналитику – на запросы по нему приходит 404, сбор по ссылкам останавливается. Сам объект остаётся: его видно в списке, можно переименовать и включить обратно.

PUT
/v2/groups/{group_id}

Параметры

group_idчислообязательный

Объект, которую нужно изменить.

Тело запроса

nameстрока

Новое название, 1–255 символов. Не передано – остаётся прежним.

is_activeда/нет

Включить или выключить объект. Не передано – остаётся как было.

Ответ

idчисло

Идентификатор объекта.

nameстрока

Название объекта.

is_activeда/нет

Включён ли объект.

scrape_statusстрокаpending / in_progress / success / partial / failed

Итог последнего сбора по объекту: success – собрались все площадки, partial – часть, failed – ни одной, in_progress – сбор идёт, pending – собирать пока нечего. Выключенные ссылки не в счёт.

last_scraped_atдата и времяможет быть пустым

Когда по объекту последний раз собирали отзывы: самая поздняя дата среди включённых ссылок.

created_atдата и время

Когда объект создан.

linksсписок объектов

Страницы объекта на площадках.

links[].idчисло

Идентификатор ссылки.

links[].urlстрока

Адрес страницы объекта на площадке.

links[].source_idчисло

Площадка, к которой относится ссылка.

links[].link_nameстрокаможет быть пустым

Своё название ссылки внутри объекта.

links[].auto_nameстрокаможет быть пустым

Название, прочитанное с площадки, с её подписью впереди (2ГИС: Кофейня Север). Пока имя не прочитано, остаётся одна подпись. Своё link_name важнее.

links[].is_activeда/нет

Собираются ли отзывы по этой ссылке.

links[].scrape_statusстрокаpending / in_progress / success / failed

Чем кончился последний сбор: pending, in_progress, success или failed.

links[].scrape_errorстрокаможет быть пустым

Что помешало последнему сбору.

links[].last_scraped_atдата и времяможет быть пустым

Когда по ссылке последний раз собирали отзывы.

links[].last_scraped_review_dateдата и времяможет быть пустым

Дата публикации самого свежего собранного отзыва.

links[].created_atдата и время

Когда ссылка добавлена в объект.

curl -X PUT "https://example.com/v2/groups/0" \  -H "Content-Type: application/json" \  -d '{    "name": "Гостиница «Националь»"  }'
{  "id": 20,  "name": "Гостиница «Националь»",  "is_active": true,  "scrape_status": "success",  "last_scraped_at": "2026-08-04T05:06:04",  "created_at": "2026-02-23T17:29:38",  "links": [    {      "id": 177,      "url": "https://yandex.com/maps/org/national/1020542995",      "source_id": 1,      "link_name": "Яндекс Националь",      "auto_name": "Яндекс.Карты: Националь",      "is_active": true,      "scrape_status": "success",      "scrape_error": null,      "last_scraped_at": "2026-08-04T05:06:03",      "last_scraped_review_date": "2026-08-03T09:42:39",      "created_at": "2026-02-23T17:30:52"    },    {      "id": 178,      "url": "https://ostrovok.ru/hotel/russia/moscow/mid7467340/gostinitsa_natsional_moskva",      "source_id": 106,      "link_name": "Островок Националь",      "auto_name": "Ostrovok: Гостиница Националь Москва",      "is_active": true,      "scrape_status": "success",      "scrape_error": null,      "last_scraped_at": "2026-08-04T05:06:04",      "last_scraped_review_date": "2026-08-02T13:04:59",      "created_at": "2026-02-23T17:32:06"    }  ]}

Коды ошибок общие для всего API и описаны на странице Ошибки.