Сводная аналитика

Итоги по отзывам за период: средняя оценка, распределение по звёздам и то, как отвечали на отзывы – целиком и в разбивке по площадкам.

Считать можно по одному объекту или по папке целиком: укажите ровно одно – object_id или folder_id.

Параметры

folder_idчисло

Папка целиком: все её объекты и подпапки. Вместе с object_id не передаётся.

object_idчисло

Объект, по которому считать.

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

Считать только по этим площадкам. Пусто – по всем площадкам объекта.

published_fromдата

Начало периода по дате публикации отзыва. По умолчанию 2000-01-01.

published_toдата

Конец периода по дате публикации. По умолчанию сегодня.

min_ratingчисло0–5по умолчанию 1

Учитывать отзывы с оценкой не ниже указанной.

max_ratingчисло1–5по умолчанию 5

Учитывать отзывы с оценкой не выше указанной.

Ответ

summaryобъект

Итоги за период.

summary.review_countчисло

Сколько всего отзывов за период.

summary.average_ratingчисломожет быть пустым

Средняя оценка по шкале 1–5, до двух знаков.

summary.reviews_with_textчисломожет быть пустым

Сколько отзывов с текстом.

summary.reviews_with_imagesчисломожет быть пустым

Сколько отзывов с фотографиями.

summary.rating_distributionобъектможет быть пустым

Сколько отзывов на каждую оценку. Ключи от 1 до 5.

summary.replyобъектможет быть пустым

Как отвечали на отзывы за период.

summary.reply.reviews_with_replyчисло

Сколько отзывов получили ответ организации.

summary.reply.unanswered_negative_countчисло

Сколько отзывов с оценкой 1–2 остались без ответа.

summary.reply.last_reply_dateдатаможет быть пустым

Когда организация отвечала в последний раз.

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

То же самое, но по каждой площадке отдельно.

by_source[].source_idчисло

Идентификатор площадки.

by_source[].source_nameстрока

Название площадки.

by_source[].review_countчисло

Сколько отзывов с этой площадки за период.

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

Средняя оценка по площадке.

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

Сколько отзывов с ответом организации.

by_source[].rating_distributionобъектможет быть пустым

Распределение отзывов площадки по оценкам.

by_source[].latest_review_dateдатаможет быть пустым

Дата самого свежего отзыва с этой площадки.

accessобъектможет быть пустым

Ограничение выдачи, если показали не всё.

access.reasonстрока

Почему выдача ограничена. trial — пробный доступ, manual — ограничение, согласованное по вашему договору.

access.limit_per_linkчисло

Сколько последних отзывов показывается по КАЖДОЙ ссылке (площадке объекта).

access.hidden_totalчисло

Сколько отзывов уже собрано сверх показанных. Считается по всему архиву и не зависит от фильтров запроса.

access.messageстрока

Готовая формулировка для показа человеку.

Ещё 12 полей – реже нужны

metaобъект

Что именно посчитано: фильтры в том виде, в котором применились.

meta.object_idчисломожет быть пустым

Объект, по которому посчитано. В папочном режиме пусто.

meta.folder_idчисломожет быть пустым

Папка, если считали по папке.

meta.object_idsсписок чисел

Все объекты, попавшие в расчёт. В папочном режиме это состав папки вместе с подпапками.

meta.published_fromдата

Начало периода, которое применилось.

meta.published_toдата

Конец периода, который применился.

meta.source_idsсписок чисел

Площадки, которые применились. Пустой список – все площадки объекта.

meta.generated_atдата и время

Когда посчитано.

summary.reply.reply_by_ratingобъектможет быть пустым

Сколько ответов дано на отзывы каждой оценки.

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

Сколько отзывов с текстом.

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

Сколько отзывов с фотографиями.

by_source[].reply_distributionобъектможет быть пустым

Распределение ответов организации по оценке отзыва.

curl -X GET "https://example.com/v3/analytics"

{  "meta": {    "object_id": 20,    "folder_id": null,    "object_ids": [      20    ],    "published_from": "2000-01-01",    "published_to": "2026-08-25",    "source_ids": [      1,      2,      3,      104,      105,      106,      108    ],    "generated_at": "2026-08-25T05:43:00.078703Z"  },  "summary": {    "review_count": 5838,    "average_rating": 4.51,    "reviews_with_text": 3929,    "reviews_with_images": 718,    "rating_distribution": {      "1": 254,      "2": 133,      "3": 358,      "4": 964,      "5": 4127    },    "reply": {      "reviews_with_reply": 1327,      "unanswered_negative_count": 287,      "reply_by_rating": {        "1": 65,        "2": 35,        "3": 104,        "4": 192,        "5": 931      },      "last_reply_date": "2026-08-20"    }  },  "by_source": [    {      "source_id": 2,      "source_name": "Google Maps",      "review_count": 3301,      "average_rating": 4.52,      "reviews_with_reply": 0,      "reviews_with_text": 1727,      "reviews_with_images": 207,      "rating_distribution": {        "1": 149,        "2": 70,        "3": 165,        "4": 457,        "5": 2460      },      "reply_distribution": {        "1": 0,        "2": 0,        "3": 0,        "4": 0,        "5": 0      },      "latest_review_date": "2026-08-24"    },    {      "source_id": 1,      "source_name": "Яндекс.Карты",      "review_count": 1092,      "average_rating": 4.48,      "reviews_with_reply": 1043,      "reviews_with_text": 1092,      "reviews_with_images": 346,      "rating_distribution": {        "1": 56,        "2": 30,        "3": 69,        "4": 119,        "5": 818      },      "reply_distribution": {        "1": 51,        "2": 26,        "3": 64,        "4": 115,        "5": 787      },      "latest_review_date": "2026-08-23"    },    {      "source_id": 106,      "source_name": "Островок",      "review_count": 698,      "average_rating": 4.54,      "reviews_with_reply": 159,      "reviews_with_text": 473,      "reviews_with_images": 63,      "rating_distribution": {        "1": 7,        "2": 15,        "3": 87,        "4": 303,        "5": 286      },      "reply_distribution": {        "1": 2,        "2": 5,        "3": 33,        "4": 71,        "5": 48      },      "latest_review_date": "2026-08-24"    },    {      "source_id": 3,      "source_name": "2ГИС",      "review_count": 442,      "average_rating": 4.47,      "reviews_with_reply": 125,      "reviews_with_text": 442,      "reviews_with_images": 51,      "rating_distribution": {        "1": 29,        "2": 11,        "3": 21,        "4": 43,        "5": 338      },      "reply_distribution": {        "1": 12,        "2": 4,        "3": 7,        "4": 6,        "5": 96      },      "latest_review_date": "2026-08-16"    },    {      "source_id": 104,      "source_name": "Яндекс.Путешествия",      "review_count": 251,      "average_rating": 4.56,      "reviews_with_reply": 0,      "reviews_with_text": 150,      "reviews_with_images": 39,      "rating_distribution": {        "1": 10,        "2": 6,        "3": 13,        "4": 25,        "5": 195      },      "reply_distribution": {        "1": 0,        "2": 0,        "3": 0,        "4": 0,        "5": 0      },      "latest_review_date": "2026-08-25"    },    {      "source_id": 108,      "source_name": "TopHotels",      "review_count": 32,      "average_rating": 4.32,      "reviews_with_reply": 0,      "reviews_with_text": 28,      "reviews_with_images": 12,      "rating_distribution": {        "1": 3,        "2": 1,        "3": 2,        "4": 9,        "5": 17      },      "reply_distribution": {        "1": 0,        "2": 0,        "3": 0,        "4": 0,        "5": 0      },      "latest_review_date": "2025-06-11"    },    {      "source_id": 105,      "source_name": "101Hotels",      "review_count": 22,      "average_rating": 4.76,      "reviews_with_reply": 0,      "reviews_with_text": 17,      "reviews_with_images": 0,      "rating_distribution": {        "1": 0,        "2": 0,        "3": 1,        "4": 8,        "5": 13      },      "reply_distribution": {        "1": 0,        "2": 0,        "3": 0,        "4": 0,        "5": 0      },      "latest_review_date": "2026-05-06"    }  ]}

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