Analytics API

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