Sign in

v1

latestOpenAPI 3.0.42026-08-06124112344.5 KB
AdHawk

Gets media play statistics aggregated by file.

get/adhawk/mediaplaystats

Query parameters

startDatestring date-time

Start date for the query (required)

endDatestring date-time

End date for the query (required)

deviceIdstring[]

Optional list of device IDs to filter by

fileIdstring[]

Optional list of file IDs to filter by

limitinteger

Maximum number of results (default: 100, max: 10000)

Response

OK

file_idstring nullable

The media file ID

file_namestring nullable

The media file name

total_playsinteger

Total number of times this media was played

total_durationinteger

Total duration of all plays in seconds

avg_durationnumber double nullable

Average play duration in seconds

device_countinteger

Number of unique devices that played this media