---
title: "Оценка объекта на площадках"
method: GET
path: "/v3/ratings"
tags: ["reviews"]
---

# Оценка объекта на площадках

`GET /v3/ratings`

## Request

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

Оценка объекта – числовые значения рейтинга, выбранные пользователями.
Отзыв – оценка с текстом.

По каждой ссылке приходит последнее известное значение: оценка, число
оценок и число отзывов **по данным площадки**.

Необходимо указать либо объект (`object_id`), либо папку (`folder_id`) –
ровно один из двух.

Ссылка, по которой замеров ещё не было, в ответе не появляется. Чтобы
отслеживать динамику оценки, воспользуйтесь `GET /v3/ratings/history`.

## Query parameters

- `folder_id` integer, nullable: Оценки по всей папке: все объекты папки и её подпапок. Взаимоисключим с `object_id` — ровно один из двух. Выключенные и удалённые объекты в состав не входят.
- `source_ids` integer[]: Фильтр по площадкам: id из `GET /v3/sources`. Пусто — все площадки.
- `object_id` integer, nullable: Идентификатор объекта. Взаимоисключим с `folder_id` — в запросе должен быть ровно один из двух.
- `link_ids` integer[]: Filter by link IDs.

## Response `200`

Successful Response

- ReturnAllRatingV3
  - `data` RatingV3[], required: Все элементы (пагинации нет).
    - `link_id` integer, required: Идентификатор ссылки (страницы объекта на площадке).
    - `source_id` integer, required: Идентификатор площадки. Берётся из `GET /v3/sources`.
    - `rating` number, nullable: Рейтинг объекта на площадке, шкала 1–5. `null` — площадка рейтинг не публикует.
    - `rating_count` integer, nullable: Сколько оценок сформировали рейтинг, **по данным площадки**. Оценка — это выставленные звёзды, и всё; текст к ним не обязателен. `null` — площадка числа не публикует.
    - `review_count` integer, nullable: Сколько на площадке отзывов, то есть оценок с текстом или фото, **по данным площадки**. Это не то же, что число собранных нами отзывов: площадка считает и то, что мы ещё не забрали или что скрыто от сбора. `null` — площадка числа не публикует.
    - `measured_at` string, date-time, 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)