---
title: "Contents analytics"
method: GET
path: "/projects/{project_id}/content/analytics"
tags: ["Analytics"]
---

# Contents analytics

`GET /projects/{project_id}/content/analytics`

Retrieves an analytics overview for all content items in a project

## Query parameters

- `media_variants[]` string[]
- `media_formats[]` string[]
- `time_range[start]` string
- `time_range[end]` string
- `pagination[limit]` integer
- `pagination[offset]` integer
- `order[by]` 'player_impressions' | 'listens' | 'listen_rate' | 'avg_listen_time' | 'avg_listen_duration'
- `order[dir]` 'asc' | 'desc'
- `access_tiers[]` string[]
- `filter[title]` string
- `filter[player_impressions][to]` integer
- `filter[player_impressions][from]` integer
- `filter[listens][to]` integer
- `filter[listens][from]` integer
- `filter[listen_rate][to]` integer
- `filter[listen_rate][from]` integer
- `filter[avg_listen_time][to]` integer
- `filter[avg_listen_time][from]` integer
- `filter[avg_listen_duration][to]` integer
- `filter[avg_listen_duration][from]` integer

## Response `200`

OK

- object[]
  - `id` string, nullable — Content identifier
  - `source_id` string — Externally provided content identifier
  - `source_url` string, uri, nullable — URL of the source content
  - `image_url` string, uri, nullable — Content image URL
  - `title` string, nullable — Content title
  - `player_impressions` integer — Number of player loads (audio or video)
  - `listens` integer — Number of play sessions (audio or video)
  - `listen_rate` number — Proportion of impressions that resulted in a play (0.0–1.0)
  - `avg_listen_time` integer — Average play time per session in seconds (audio or video). This metric may be understated when play progress is stored as every 10% milestone event per session instead of only a final event.
  - `avg_listen_duration` number — Average percentage of the item consumed (0-100). This metric may be understated when play progress is stored as every 10% milestone event per session instead of only a final event.
  - `published` string, date-time, nullable — Time at which the content was published (ISO 8601)
  - `media` object, nullable
    - `url` string, uri — URL of the media file
    - `duration` integer — Duration of the media file in milliseconds

---

[API](https://skmtc.net/beyondwords/apis/beyondwords-rest-api.md) · [All operations](https://skmtc.net/beyondwords/apis/beyondwords-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/beyondwords/beyondwords-rest-api/revisions/8c4bfe3e2ebd/schema)