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

Ваши объекта вместе со ссылками на площадки – от новых к старым.

Параметры

limitчисло1–1000по умолчанию 100

Сколько объектов вернуть за один запрос.

offsetчислоне меньше 0по умолчанию 0

Сколько объектов пропустить с начала списка.

Ответ

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дата и время

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

totalчисло

Сколько всего у вас объектов.

limitчисло

Размер страницы, применённый к запросу.

offsetчисло

Смещение, применённое к запросу.

has_nextда/нет

Есть ли ещё объекта за текущей страницей.

curl -X GET "https://example.com/v3/objects"

{  "data": [    {      "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"        }      ]    }  ],  "total": 14,  "limit": 100,  "offset": 0,  "has_next": false}

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