Оценка на площадках

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

Необходимо указать либо объект, либо папку.

Чтобы отслеживать динамику оценки, воспользуйтесь методом Динамика оценки.

Параметры

object_id · folder_idчисло

Объект или папка целиком. В запросе должно быть ровно одно из двух.

link_ids · source_idsсписок чиселпо умолчанию пусто

Ограничить выдачу конкретными ссылками объекта или площадками. Пусто – без ограничения.

Ответ

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

По строке на каждую ссылку, у которой есть замер.

data[].link_idчисло

Ссылка, к которой относится оценка.

data[].source_idчисло

Площадка, на которой она показана.

data[].ratingчисломожет быть пустым

Оценка объекта на площадке, шкала 1–5.

data[].rating_countчисломожет быть пустым

Сколько оценок её сформировали, вместе с оставленными без текста.

data[].review_countчисломожет быть пустым

Сколько из этих оценок – отзывы с текстом, по данным самой площадки.

data[].measured_atдата и время

Когда мы последний раз сверялись с площадкой и видели это значение.

curl -X GET "https://example.com/v3/ratings?object_id=20"

{  "data": [    {      "link_id": 794,      "source_id": 1,      "rating": 4.9,      "rating_count": 966,      "review_count": 286,      "measured_at": "2026-08-27T05:21:23"    },    {      "link_id": 823,      "source_id": 3,      "rating": 4.8,      "rating_count": 237,      "review_count": 193,      "measured_at": "2026-08-27T05:21:40"    },    {      "link_id": 830,      "source_id": 3,      "rating": 4.8,      "rating_count": 21,      "review_count": 17,      "measured_at": "2026-08-27T05:21:48"    }  ]}

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