---
title: "Как менялась оценка на площадках"
method: GET
path: "/v3/ratings/history"
tags: ["analytics"]
---

# Как менялась оценка на площадках

`GET /v3/ratings/history`

## Request

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

Ряд изменений оценки по каждой ссылке – свежее первым.

Новое значение оценки записывается только в том случае, если оно
изменилось.

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

## Query parameters

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

## Response `200`

Successful Response

- ReturnAllRatingHistoryV3
  - `data` RatingHistoryV3[], required: Все элементы (пагинации нет).
    - `link_id` integer, required: Идентификатор ссылки (страницы объекта на площадке).
    - `source_id` integer, required: Идентификатор площадки. Берётся из `GET /v3/sources`.
    - `points` RatingPointV3[], required: Точки ряда, свежая первой. Каждая — отрезок, на котором значение держалось: `measured_at` соседней точки снизу говорит, когда прежнее значение видели в последний раз.
      - `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)