---
title: "Download Empower analytics and statistics"
method: POST
path: "/empower/analytics"
tags: ["empower"]
---

# Download Empower analytics and statistics

`POST /empower/analytics`

Retrieves Empower analytics and statistics (e.g. Leaderboard) for the given filters. The response format is controlled by the `output` field in the request body: use `json` for JSON or `csv` to download as a CSV file.

**Permission:** `Empower Read` required.

**Monitoring:** No impact. Visibility depends on your Empower role.

## Request body

- object
  - `user_id` integer[] — Optional list of user IDs to filter by.
  - `group_id` integer[] — Optional list of group IDs to filter by.
  - `time_frame` object
    - `start_time` string, date-time, required — Start of the time range (ISO 8601).
    - `end_time` string, date-time, required — End of the time range (ISO 8601).
  - `output` 'json' | 'csv' — Response format; use `csv` to download as a file.
  - `type` string — Stats type requested (e.g. Leaderboard).

## Response `200`

Successful operation. Body is JSON or CSV depending on `output`.

- object — Structure depends on the requested stats type (e.g. Leaderboard). Contains charts, graph (time-series), and users (leaderboard).
  - `charts` object — Aggregated chart metrics (over_avg_*, over_sum_*). Each key has value and optional last_value.
  - `graph` object[] — Time-series data points per period.
    - `t_date` string, date-time
    - `avg_talk_ratio` number
    - `avg_longest_monologue` number
    - `avg_number_of_interruptions` integer
    - `avg_words_rate` number
    - `avg_call_rating` number
    - `avg_number_of_interactivity` integer
    - `avg_duration_in_s` number
    - `sum_mood_positive` integer
    - `sum_mood_neutral` integer
    - `sum_mood_negative` integer
    - `sum_mood_slightly_positive` integer
    - `sum_mood_slightly_negative` integer
    - `sum_mood_is_null` integer
  - `users` object[] — Per-user leaderboard stats and most_used_moments.
    - `user_id` integer
    - `total_call` integer
    - `min_longest_monologue` number — Minimum longest monologue duration (seconds).
    - `max_longest_monologue` number — Maximum longest monologue duration (seconds).
    - `avg_talk_ratio` number
    - `avg_longest_monologue` number
    - `avg_call_rating` number
    - `avg_duration_in_s` number — Average call duration in seconds.
    - `sum_mood_neutral` integer — Count of neutral mood segments.
    - `sum_mood_slightly_negative` integer — Count of slightly negative mood segments.
    - `most_used_moments` object[]
      - `moment_id` integer
      - `moment_label` string
      - `count` integer

## Other responses

- `204` — No content — no data found for the given filters.
- `400` — Bad request — invalid body or parameters.
- `401` — Unauthorized — missing or invalid token, or insufficient Empower Read permission.
- `500` — Internal server error.

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)