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

Включить или выключить объекты

Доступ для AI:

Включает или выключает до 200 объектов за один вызов.

Переключается всё, что доступно: чужой, несуществующий или удалённый group_id молча пропускается, остальные объекта набора всё равно переключаются. В ответе – только те, что переключились.

PUT
/v2/groups

Тело запроса

group_idsсписок чиселобязательный

Объекты, которые нужно переключить, от 1 до 200 за запрос. Повторы схлопываются.

is_activeда/нетобязательный

Куда переключить весь набор: true включить, false выключить.

Ответ

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

Объекты после переключения. Пагинации нет.

data[].idчисло

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

data[].nameстрока

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

data[].is_activeда/нет

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

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

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

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

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

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

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

data[].linksсписок объектов

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

data[].links[].idчисло

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

data[].links[].urlстрока

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

data[].links[].source_idчисло

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

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

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

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

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

data[].links[].is_activeда/нет

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

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

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

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

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

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

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

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

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

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

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

curl -X PUT "https://example.com/v2/groups" \  -H "Content-Type: application/json" \  -d '{    "group_ids": [      20,      21    ],    "is_active": false  }'
{  "data": [    {      "id": 20,      "name": "Националь",      "is_active": false,      "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 и описаны на странице Ошибки.