Players AnalyticsAnalytics Statistics

Analytics Statistics

curl -X POST "https://api.5centscdn.com/v2/players/5centscdn/analytics/stats" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
  "r": "2026-01-01 00:00:00 - 2026-01-31 23:59:59",
  "granularity": "1h",
  "assets": "1,234,567,890",
  "title": "sample-video.mp4/playlist.m3u8",
  "tag": "live"
}'
{
  "aggregate": {
    "concurrent": 2,
    "impression": 23,
    "page_load": 4586,
    "play": 15,
    "player_load": 1407,
    "total_played": 40,
    "unique": 9,
    "hits": 110,
    "complete": 1
  },
  "concurrent": [
    {
      "count": 1,
      "date": "2026-01-20 03:00"
    }
  ],
  "impression": [
    {
      "count": 1,
      "date": "2026-01-20 06:00"
    }
  ],
  "page_load": [
    {
      "count": 1020,
      "date": "2026-01-20 06:00"
    }
  ],
  "play": [
    {
      "count": 1,
      "date": "2026-01-20 06:00"
    }
  ],
  "player_load": [
    {
      "count": 1632,
      "date": "2026-01-20 06:00"
    }
  ],
  "total_played": [
    {
      "count": 40,
      "date": "2026-01-20 03:00"
    }
  ],
  "unique": [
    {
      "count": 1,
      "date": "2026-01-20 06:00"
    }
  ]
}
POST
/players/5centscdn/analytics/stats
POST
Base URLstring

Target server for requests. Edit to use your own host.

API Key (header: X-API-Key)
X-API-Keystring
Required

API key (sent in header)

Content-Typestring
Required

The media type of the request body

Options: application/json
rstring

Date range string in UTC format: "YYYY-MM-DD HH:mm:ss - YYYY-MM-DD HH:mm:ss". Defines the reporting window.

granularitystring

Time granularity for data aggregation. One of: 1m, 5m, 15m, 1h, 1d, 1M.

assetsstring

Comma-separated asset IDs filter. Retrieve available IDs from POST /players/5centscdn/analytics/search/assets.

titlestring

Comma-separated title IDs filter. Retrieve available values from POST /players/5centscdn/analytics/search/titles.

tagstring

Comma-separated tag IDs filter. Retrieve available values from POST /players/5centscdn/analytics/search/tags.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
X-API-Keystring
Required

API Key for authentication. Provide your API key in the header.

Body

application/json
rstring

Date range string in UTC format: "YYYY-MM-DD HH:mm:ss - YYYY-MM-DD HH:mm:ss". Defines the reporting window.

Example:
2026-01-01 00:00:00 - 2026-01-31 23:59:59
granularitystring

Time granularity for data aggregation. One of: 1m, 5m, 15m, 1h, 1d, 1M.

Example:
1h
assetsstring

Comma-separated asset IDs filter. Retrieve available IDs from POST /players/5centscdn/analytics/search/assets.

Example:
1,234,567,890
titlestring

Comma-separated title IDs filter. Retrieve available values from POST /players/5centscdn/analytics/search/titles.

Example:
sample-video.mp4/playlist.m3u8
tagstring

Comma-separated tag IDs filter. Retrieve available values from POST /players/5centscdn/analytics/search/tags.

Example:
live

Responses

aggregateobject

Aggregated totals across the entire requested date range.

concurrentarray

Time-series data points for concurrent viewer counts.

impressionarray

Time-series data points for impression event counts.

page_loadarray

Time-series data points for page load event counts.

playarray

Time-series data points for play event counts.

player_loadarray

Time-series data points for player load event counts.

total_playedarray

Time-series data points for total playback duration in seconds.

uniquearray

Time-series data points for unique viewer session counts.