---
title: "Aggregated Data"
method: POST
path: "/insights/aggregated-data"
tags: ["API Endpoints"]
---

# Aggregated Data

`POST /insights/aggregated-data`

This endpoint retrieves aggregated data of the given metrics.

## Request body

- object
  - `aggregate` object[], required — Aggregate multiple metrics at the same time
    - `metric` 'views' | 'unique_views' | 'downscale_percentage' | 'upscale_percentage' | 'rebuffer_percentage' | 'startup_time' | 'player_startup_time' | 'seek_latency' | 'exits_before_startup' | 'playback_failure_percentage' | 'completion_percent' | 'completion_percent_by_views' | 'rebuffer_duration' | 'playing_time' | 'rebuffer_count' | 'rebuffer_frequency' | 'average_bitrate' | 'concurrent_users' | 'playback_rate', required — The metric to be aggregated for this request.
    - `function` 'sum' | 'average', required — Aggregation function which is to be used.
  - `property_id` string, required — The five to ten character unique identifier of the Gumlet Insight Property available on the dashboard.
  - `timeframe` object, required — The timeframe to get the data for. Currently we only support maximum difference between `start_at` and `end_at` to be *60 days*
    - `start_at` string, date — Use <b>yyyy-MM-dd</b> format
    - `end_at` string, date — Use <b>yyyy-MM-dd</b> format
  - `filters` object[] — Get aggregations for metrics with multiple filters, `value` should be an exact match
    - `name` 'meta_browser' | 'meta_operating_system' | 'meta_operating_system_version' | 'meta_device_category' | 'meta_device_manufacturer' | 'meta_device_is_touchscreen' | 'meta_connection_type' | 'meta_connection_speed' | 'meta_device_name' | 'meta_device_display_width' | 'meta_device_display_height' | 'meta_country' | 'meta_continent_code' | 'meta_city' | 'meta_region' | 'player_software' | 'player_software_version' | 'player_height_pixels' | 'player_width_pixels' | 'player_language_code' | 'player_name' | 'player_integration_version' | 'meta_page_url' | 'meta_asn' | 'custom_user_id' | 'user_name' | 'user_email' | 'user_phone' | 'user_city' | 'user_state' | 'user_country' | 'user_zipcode' | 'custom_video_id' | 'custom_video_title' | 'video_source_url' | 'video_source_hostname' | 'video_source_format' | 'custom_encoding_variant' | 'custom_video_variant_name' | 'custom_video_producer' | 'custom_video_series' | 'custom_video_language' | 'custom_video_variant' | 'custom_content_type' | 'custom_data_1' | 'custom_data_2' | 'custom_data_3' | 'custom_data_4' | 'custom_data_5' | 'custom_data_6' | 'custom_data_7' | 'custom_data_8' | 'custom_data_9' | 'custom_data_10', required — Name of the breakdown to filter data on.
    - `value` string, required — Value to be matched for the given filter name. Currently we support exact matches.
    - `operator` 'equals' | 'does not equal' | 'contains' | 'does not contain' | 'is set' | 'is not set' — Operator to be used while filtering the data

## Response `200`

200

- object
  - `views` object
    - `sum` object
      - `value` integer
      - `unit` string

## Other responses

- `400` — 400
- `401` — 401

---

[API](https://skmtc.net/gumlet/apis/gumlet-rest-apis.md) · [All operations](https://skmtc.net/gumlet/apis/gumlet-rest-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gumlet/gumlet-rest-apis/versions/b1f7ac2aeeec/schema)