Аналитика

Динамика оценки

Доступ для AI:

Ряд изменений оценки по каждой ссылке. Текущее значение отдельно – на странице Оценка на площадках.

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

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

GET
/v3/ratings/history

Параметры

measured_from · measured_toдата

Границы по дате замера, включительно. Названный в верхней границе день входит целиком. Не переданы – вся история.

object_id · folder_idчисло

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

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

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

Ответ

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

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

data[].link_idчисло

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

data[].source_idчисло

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

data[].pointsсписок объектов

Точки ряда, свежая первой.

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

Какой стала оценка, шкала 1–5.

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

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

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

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

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

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

curl -X GET "https://example.com/v3/ratings/history?object_id=20"
{  "data": [    {      "link_id": 794,      "source_id": 1,      "points": [        {          "rating": 4.9,          "rating_count": 966,          "review_count": 286,          "measured_at": "2026-08-27T05:21:23"        },        {          "rating": 4.8,          "rating_count": 941,          "review_count": 279,          "measured_at": "2026-08-23T05:19:44"        }      ]    },    {      "link_id": 823,      "source_id": 3,      "points": [        {          "rating": 4.8,          "rating_count": 237,          "review_count": 193,          "measured_at": "2026-08-27T05:21:40"        }      ]    }  ]}

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