Use this controller to retrieve statistic information for a given mediacontainer or aggregated for the customer.
Reference
MediaContainer Statistic
TBC
GET/v4/statistic
Request Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| aggregatedBy | array | ✗ | TBA |
| endDate | string | ✗ | optional end date for statistic |
| field | string | ✗ | TBA allowed values: *countViewwatchTimecountDownloadcountPlaybrowser_familyreferer_domaincitycountryengagementfinishesidentifiermediaIdssubtitlewatchTimelogDayos |
| fields | array | ✗ | TBA |
| file | string | ✗ | TBA allowed values: xlsx-binaryxlsx-bufferxlsx-base64csv-stringcsv-base64 |
| identifier | string | ✗ | filter for identifier |
| limit | integer | ✗ | TBA |
| mediaContainerId | integer | ✗ | mediaContainer to get stats for |
| model | string | ✗ | Model to use, defaults to general allowed values: browsergeneralgeoidentifierreferer_domainoriginsource |
| order | string | ✗ | TBA allowed values: descasc |
| referer_domain | string | ✗ | filter for referer_domain |
| startDate | string | ✗ | start date for statistic |
Customer Statistic
Aggregated statistic for the logged in customer. This endpoint delivers information in regards to asset performance. Do not use this endpoint for consumption stats of quotas.
GET/v4/statistic/customer
Request Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| endDate | string | ✗ | optional end date for statistic |
| startDate | string | ✗ | start date for statistic |
Response
| Field | Type | Description |
|---|---|---|
| endDate | string | optional end date for statistic |
| startDate | string | start date for statistic |
Customer Consumption Statistic
Delivers consumption statistic for storage, traffic, users and assets.
This call is new and delivers historical data for dates before 2023-12-10. Please note, that storage files differ for entries before that date, due to changes in the calculation. This value has not been and is not used for billing.
GET/v4/statistic/customer/consumption
Request Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| endDate | string | ✗ | optional end date for statistic |
| startDate | string | ✗ | start date for statistic |
Response
| Field | Type | Description |
|---|---|---|
| assets | array | Asset stats for the given time period |
| └ type | string | Asset type, e.g. image, video, mediahub… |
| └ cnt | number | Max number of files in the given period |
| endDate | string | optional end date for statistic |
| startDate | string | start date for statistic |
| storage | object | Storage statistics |
| └ avgStorage | float | Average storage in the given period in bytes |
| └ maxStorage | integer | Maximum storage in the given period in bytes. The relevant value for calculation. |
| └ minStorage | integer | Minimum storage |
| └ avgFiles | float | Average number of files |
| └ avgStorage_human | string | Average storage in the given period in human readable format |
| └ maxStorage_human | string | Maximum storage in the given period in human readable format. The relevant value for calculation. |
| traffic | object | Traffic statistics |
| └ traffic | integer | Total Traffic in bytes in the given period |
| └ requests | integer | Total number of requests in the given period |
| └ traffic_human | string | Total Traffic in human readable format in the given period |
| users | array | User stats for the given time period |
| └ clientId | string | Client ID |
| └ isAdmin | number | Admin status allowed values: 01 |
| └ cnt | number | Max number of users for the admin status and clientId in the given period |