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

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

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

Параметры

folder_idчисло

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

group_idчисло

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

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

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

published_fromдата

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

published_toдата

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

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

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

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

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

Ответ

summaryобъект

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

summary.total_reviewsчисло

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

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

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

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

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

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

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

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

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

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

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

summary.reply.total_with_replyчисло

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

summary.reply.unanswered_negativeчисло

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

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

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

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

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

by_source[].source_idчисло

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

by_source[].source_nameстрока

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

by_source[].review_countчисло

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

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

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

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

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

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

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

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

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

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

Ограничение выдачи. Присутствует только когда пробному доступу показали не всё — у обычного клиента ключа нет. Пробный срез применяется ДО подсчёта, поэтому без этого поля урезанные числа выглядят полными.

access.reasonстрока

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

access.limit_per_linkчисло

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

access.hidden_totalчисло

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

access.messageстрока

Готовая формулировка на английском. Для интерфейса на другом языке стройте текст по числам выше.

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

metaобъект

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

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

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

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

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

meta.group_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/v2/analytics"

{  "meta": {    "group_id": 20,    "folder_id": null,    "group_ids": [      20    ],    "published_from": "2026-07-01",    "published_to": "2026-08-04",    "source_ids": [      1,      2,      3,      104,      105,      106,      108    ],    "generated_at": "2026-08-04T06:28:19.757680Z"  },  "summary": {    "total_reviews": 82,    "avg_rating": 4.53,    "reviews_with_text": 66,    "reviews_with_images": 14,    "rating_distribution": {      "1": 5,      "2": 1,      "3": 5,      "4": 14,      "5": 57    },    "reply": {      "total_with_reply": 31,      "unanswered_negative": 6,      "reply_by_rating": {        "1": 0,        "2": 0,        "3": 2,        "4": 6,        "5": 23      },      "last_reply_date": "2026-07-23"    }  },  "by_source": [    {      "source_id": 1,      "source_name": "Яндекс.Карты",      "review_count": 31,      "avg_rating": 4.68,      "total_with_reply": 20,      "reviews_with_text": 31,      "reviews_with_images": 7,      "rating_distribution": {        "1": 2,        "2": 0,        "3": 0,        "4": 2,        "5": 27      },      "reply_distribution": {        "1": 0,        "2": 0,        "3": 0,        "4": 1,        "5": 19      },      "latest_review_date": "2026-08-03"    },    {      "source_id": 106,      "source_name": "Ostrovok",      "review_count": 21,      "avg_rating": 4.58,      "total_with_reply": 9,      "reviews_with_text": 14,      "reviews_with_images": 2,      "rating_distribution": {        "1": 0,        "2": 0,        "3": 4,        "4": 9,        "5": 8      },      "reply_distribution": {        "1": 0,        "2": 0,        "3": 2,        "4": 5,        "5": 2      },      "latest_review_date": "2026-08-02"    },    {      "source_id": 3,      "source_name": "2ГИС",      "review_count": 14,      "avg_rating": 4.64,      "total_with_reply": 2,      "reviews_with_text": 14,      "reviews_with_images": 1,      "rating_distribution": {        "1": 1,        "2": 0,        "3": 0,        "4": 1,        "5": 12      },      "reply_distribution": {        "1": 0,        "2": 0,        "3": 0,        "4": 0,        "5": 2      },      "latest_review_date": "2026-08-02"    },    {      "source_id": 104,      "source_name": "YandexTravel",      "review_count": 12,      "avg_rating": 4.58,      "total_with_reply": 0,      "reviews_with_text": 4,      "reviews_with_images": 2,      "rating_distribution": {        "1": 0,        "2": 1,        "3": 0,        "4": 2,        "5": 9      },      "reply_distribution": {        "1": 0,        "2": 0,        "3": 0,        "4": 0,        "5": 0      },      "latest_review_date": "2026-07-29"    },    {      "source_id": 2,      "source_name": "Google",      "review_count": 4,      "avg_rating": 2.5,      "total_with_reply": 0,      "reviews_with_text": 3,      "reviews_with_images": 2,      "rating_distribution": {        "1": 2,        "2": 0,        "3": 1,        "4": 0,        "5": 1      },      "reply_distribution": {        "1": 0,        "2": 0,        "3": 0,        "4": 0,        "5": 0      },      "latest_review_date": "2026-07-31"    },    {      "source_id": 105,      "source_name": "101Hotels",      "review_count": 0    },    {      "source_id": 108,      "source_name": "TopHotels.ru",      "review_count": 0    }  ]}

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