---
title: "Список объектов"
method: GET
path: "/v3/objects"
tags: ["objects"]
---

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

`GET /v3/objects`

## Request

- Base URL: `https://api.rewio.ru`
- URL: `https://api.rewio.ru/v3/objects`
- Auth: API key in header `X-API-Key`

Список объектов с пагинацией. Порядок — `id` по убыванию.

## Query parameters

- `limit` integer: Размер страницы (1–1000). По умолчанию 100.
- `offset` integer: Смещение для пагинации.

## Response `200`

Successful Response

- PageObjectV3
  - `data` ObjectV3[], required: Элементы текущей страницы.
    - `id` integer, required: Идентификатор объекта.
    - `name` string, required: Название объекта.
    - `is_active` boolean, required: Включён ли объект. Выключенный не отдаёт отзывы и аналитику и не собирается, но остаётся у вас и продолжает занимать место в тарифе.
    - `scrape_status` 'pending' | 'in_progress' | 'success' | 'partial' | 'failed', required: Сводный статус сбора по объекту. Значения те же, что в предыдущей версии.
    - `last_scraped_at` string, date-time, nullable: Последний сбор по объекту (UTC, ISO 8601).
    - `created_at` string, date-time, required: Момент создания объекта (UTC, ISO 8601).
    - `links` LinkV3[]: Ссылки объекта на разных площадках.
      - `id` integer, required: Идентификатор ссылки.
      - `url` string, required: URL страницы объекта на площадке.
      - `source_id` integer, required: Идентификатор площадки ссылки (см. `GET /v3/sources`).
      - `link_name` string, nullable: Своё название ссылки внутри объекта, если задано.
      - `auto_name` string, nullable: Название, определённое нами по ссылке, с подписью площадки через двоеточие. Показывать стоит `link_name`, если задано, иначе `auto_name`.
      - `is_active` boolean, required: Включена ли ссылка в автосбор отзывов.
      - `scrape_status` 'pending' | 'in_progress' | 'success' | 'failed', required: Статус последнего сбора отзывов по ссылке. Значения совпадают с DB-enum `Link.scrape_status` (`app/models/link.py`).
      - `scrape_error` string, nullable: Текст ошибки последнего неудачного сбора. `null`, когда сбор успешен.
      - `last_scraped_at` string, date-time, nullable: Момент последнего сбора по ссылке (UTC, ISO 8601).
      - `last_scraped_review_date` string, date-time, nullable: Дата публикации самого свежего собранного отзыва по ссылке.
      - `created_at` string, date-time, required: Момент добавления ссылки в объект (UTC, ISO 8601).
    - `is_demo` boolean: Пример, который мы положили в кабинет при регистрации. Занимает место в тарифе, исчезает после первой оплаты; удалить можно как обычный объект.
    - `review_count` integer, nullable: Сколько отзывов объекта доступно вам сейчас: по включённым ссылкам, без удалённых на площадке, в пробном периоде — в пределах его окна. Скрытые и закреплённые через API здесь не вычитаются, поэтому `total` у `GET /v3/reviews?object_id=…` может быть меньше на их число. Есть в списке объектов и в `GET /v3/objects/{object_id}`; в ответах на изменение — `null`.
  - `total` integer, required: Общее число элементов, подходящих под фильтры (без учёта limit/offset).
  - `limit` integer, required: Размер страницы, применённый к запросу.
  - `offset` integer, required: Смещение от начала выборки, применённое к запросу.
  - `has_next` boolean, required: Есть ли ещё элементы за пределами текущей страницы.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/rewio/apis/review-aggregator.md) · [All operations](https://skmtc.dev/rewio/apis/review-aggregator/llms.txt) · [OpenAPI document](https://skmtc.dev/rewio/apis/review-aggregator/revisions/9222b6cf28a5?raw)