---
title: "Получить объект"
method: GET
path: "/v3/objects/{object_id}"
tags: ["objects"]
---

# Получить объект

`GET /v3/objects/{object_id}`

## Request

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

Получить один объект целиком — с составом ссылок и статусом сбора по каждой.

Здесь же видно `is_active` — общий выключатель объекта. Он не влияет на
доступность самого объекта: выключенный всё равно возвращается этим
методом, но `GET /v3/reviews` и `GET /v3/analytics` по нему отвечают `404`.

## Path parameters

- `object_id` integer, required: Идентификатор объекта

## Response `200`

Successful Response

- ObjectV3: Объект — единица бизнеса, отзывы по которой собираются со всех площадок.
  - `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`.

## 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)