Media Manager’s Analytics API gives you programmatic access to your views and viewers data returned in JSON.
For detailed documentation and API endpoints please log into Media Manager and select API under the ANALYTICS menu.
Basic Authentication
When you make a request to the API you need to have the authorization header set in your HTTP request. Learn more about Basic Authentication here.
IVA recommends creating a new Media Manager User granted with API access to use for accessing the analytics api.
Rate Limiting
The API is limited to 60 calls per hour.
List of parameters
- startdate – Date in MM-DD-YYYY format
- enddate – Date in MM-DD-YYYY format
- reporttag – Returns data based on reporttag, if blank all the data will be returned
- publishedid – The publishedid of the video asset you want, only used in title report (required parameter)
- datevalue – Predefined date values
- today
- yesterday
- 2-days-ago
- last-7-days
- last-14-days
- last-28-days
- last-60-days
- last-90-days
GB Usage
Returns your Gigabyte usage by month.
Supported parameters
- month – Numeric value of a month for example 1 = January
- year, for example 2013
Summary
Returns the total count of viewers, views, unique viewers and average views over the specified time period for the last 90 days.
Supported parameters
- reporttag
- datevalue
Viewers
Returns the daily count of viewers over the specified time period for the last 90 days.
Supported paramenters
- reporttag
- datevalue
Views
Returns the daily count of views over the specified time period for the last 90 days.
Supported parameters
- reporttag
- datevalue
Country
Returns the viewer count and percentage by country. Can go up to 90 days back.
Supported parameters
- startdate
- enddate
- reporttag
- datevalue
City
Returns the viewer count and percentage by city. Can go up to 90 days back.
Supported parameters
- startdate
- enddate
- reporttag
- datevalue
Web Browsers
Returns the viewer count and percentage by browser. Can go up to 90 days back.
Supported parameters
- startdate
- enddate
- reporttag
- datevalue
Platform Hardware
Returns the viewer count and percentage by hardware device, not all hardware devices are supported. Can go up to 90 days back.
Supported parameters
- startdate
- enddate
- reporttag
- datevalue
Platform Operating System
Returns the viewer count and percentage by operating system. Can go up to 90 days back.
Supported parameters
- startdate
- enddate
- reporttag
- datevalue
Video Log
Returns a list of titles with their view, viewer, and unique viewer count which is ordered by view descending. Can go up to 90 days back.
Supported parameters
- startdate
- enddate
- reporttag
- datevalue
Engagement Actions
Breaks down the engagement of users by actions performed. Can go up to 90 days back.
Supported parameters
- startdate
- enddate
- reporttag
- datevalue
Engagement Times
Breaks down the engagement of users by time spent. Can go up to 90 days back.
Supported parameters
- startdate
- enddate
- reporttag
- datevalue
Most Active
A list of users that have watched the most content on your site or app today.
Supported parameters
- reporttag
Recent Visitors
Returns a list of the most recent visitors that watched content on your site or app today.
Supported parameters
- reporttag
Title Reports
Returns views and viewers by day for a given publishedid. This query can go all the way back to June 20th, 2011. Defaults to all if startdate and enddate aren’t set.
Supported parameters
- startdate
- enddate
- publishedid