Skip to main content
View as Markdown

report.getTotal - Analytics

report.getTotal​

Retrieves aggregate totals for a report type as a single row.

Parameters

ParameterTypeRequiredDescription
reportTypeintYesKalturaReportType integer ID (see Report Types Reference)
reportInputFilter[objectType]stringYesAlways KalturaEndUserReportInputFilter
reportInputFilter[fromDate]intYesStart date as Unix timestamp in seconds
reportInputFilter[toDate]intYesEnd date as Unix timestamp in seconds
reportInputFilter[timeZoneOffset]intNoTimezone offset in minutes. Default: 0
reportInputFilter[entryIdIn]stringNoFilter by entry IDs (pipe-separated)
reportInputFilter[virtualEventIdIn]stringNoScope to virtual event(s)
responseOptions[objectType]stringNoKalturaReportResponseOptions
responseOptions[delimiter]stringNoField delimiter. Default: , (use | for consistency)
curl -X POST "$KALTURA_SERVICE_URL/service/report/action/getTotal" \
-d "ks=$KALTURA_KS" \
-d "format=1" \
-d "reportType=38" \
-d "reportInputFilter[objectType]=KalturaEndUserReportInputFilter" \
-d "reportInputFilter[fromDate]=$FROM_TIMESTAMP" \
-d "reportInputFilter[toDate]=$TO_TIMESTAMP" \
-d "responseOptions[objectType]=KalturaReportResponseOptions" \
-d "responseOptions[delimiter]=|"

Response:

{
"header": "count_plays|unique_known_users|sum_time_viewed|avg_time_viewed",
"data": "1250|340|45600|36.5",
"objectType": "KalturaReportTotal"
}