Understand how to interpret the data that comes with the Exports API.
Full data exports are available via the Exports APIAPI.
Use this API to get a list of CSV files available for download. Each CSV file is a single day of data and includes every single dimension collected by Mux, for each single video view. The table below details each of these data fields.
| Mux API Value | Unit | Type | Definition |
|---|---|---|---|
player_poster | URL | API | The image shown as the pre-visualization before play |
video_startup_preroll_request_time | Milliseconds | Metric | Total amount of Video Startup Time that is spent making preroll ad requests |
cdn | Text | Filter | CDN delivering the video view (either determined by Mux (network metrics), or provided as video_cdn (Custom Metadata)) |
video_startup_preroll_load_time | Milliseconds | Metric | Total amount of Video Startup Time that is spent loading the first preroll ad asset |
player_source_width | Integer | View | Width of the source video being as seen by the player |
video_language | Text | API | The audio language of the video, assuming it's unchangeable after playing. |
country (country_code) | ISO Code | UI | 2-letter Country Code |
viewer_application_engine | Text | API | Web Browser Engine (Gecko, WebKit, etc) |
video_duration | Milliseconds | View | (Custom Metadata) The length of the video supplied to Mux via custom metadata |
property_id | Unique ID | UI | Mux Property ID, linked with a specific environment (also sometimes called Env Key) |
player_language | Text | API | Player's text language |
player_load_time | Milliseconds | Metric | Unused (deprecated - see player_startup_time) |
latitude | Degrees | View | Latitude of the viewer, truncated to 1 decimal place |
player_source_stream_type | Text | Filter | Unused |
player_view_count | Integer | API | View Count - equal to 1 in Full Exports (1 line = 1 video view) |
preroll_ad_tag_hostname | Hostname | Filter | Hostname of a Preroll Ad Tag |
operating_system (viewer_os_family) | Text | Filter | Operating System (iOS, Windows, etc) |
video_variant_name | Text | API | (Custom Metadata) An optional detail that allows you to monitor issues with the files of specific versions of the content, for example different audio translations or versions with hard-coded/burned-in subtitles. |
max_request_latency (view_max_request_latency) | Milliseconds | Metric | Maximum time to first byte for a media request |
rebuffer_percentage | Percentage | Metric | Volume of rebuffering that is occurring across the view |
platform_description | Text | API | Unused |
experiment_name | Text | Filter | (Custom Metadata) A/B Testing: use this field to separate views into different experiments |
player_source_height | Integer | View | Height of the source video being sent to the player, in pixels |
video_content_type | Text | API | (Custom Metadata) Content Type (e.g. 'short', 'movie', 'episode', 'clip', 'trailer', or 'event') |
player_mux_plugin_version | Version | View | Mux Integration Plugin version (e.g. 2.2.0) |
view_max_downscale_percentage | Percentage | Metric | Maximum Downscale Percentage at any point in time during a video view |
viewer_device_category | Text | API | The type of device used (e.g. console, desktop, phone, tablet, tv) |
rebuffer_duration (buffering_duration) | Milliseconds | Metric | Amount of time in milliseconds that viewers wait for rebuffering per video view. |
operating_system_version (viewer_os_version) | Version | Filter | Operating System version (e.g. OS X 10.6) |
max_upscale_percentage (view_max_upscale_percentage) | Percentage | Metric | Maximum Upscale Percentage at any point in time during a video view |
preroll_played | Boolean | Filter | Flag to identify video views for which a Preroll Ad has been successfully played. |
rebuffer_frequency (buffering_rate) | Events per millisecond | Metric | Measures how often rebuffering events happen |
preroll_requested | Filter | Boolean | Flag to identify video views for which a Preroll Ad has been requested |
browser (viewer_application_name) | Text | Filter | Browser used for the video view (Safari, Chrome, etc.) |
page_type | Text | API | (Custom Metadata) Provides the context of the page for more specific analysis. Values include watchpage or iframe |
city | Text | View | City of the viewer |
view_id | Unique ID | View | Unique View Identifier |
view_total_downscaling | Milliseconds | API | Internal number used to calculate Downscale Percentage Metric. Downscale Percentage = view_total_downscaling / view_total_content_playback_time |
player_width | Integer | View | Width of the player as displayed in page, in pixels |
video_producer | Text | API | (Custom Metadata) The producer of the video title |
view_seek_count | Integer | API | The number of times that the viewer attempted to seek to a new location within the view. |
browser_version (viewer_application_version) | Version | Filter | Browser version (e.g. Chrome 66.0.3359.158) |
asn | Integer | Filter | Autonomous System Number uniquely identifying each network |
video_encoding_variant | Text | API | (Custom Metadata) An optional detail that allows you to compare different encoding settings. |
player_startup_time | Milliseconds | Metric | Measures the time from when the player is first initialized in the page to when it is ready to receive further instructions. |
metro | Text | View | Unused |
region | Text | View | Region of the viewer |
isp | Text | View | Unused |
player_autoplay | Boolean | View | Indicates whether the player autoplayed the video or not |
preroll_ad_asset_hostname | Hostname | Filter | Hostname of the Preroll Ad Asset |
player_instance_id | Unique ID | View | Identifies the instance of the Player class that is created when a video is initialized |
exits_before_video_start (exit_before_video_start) | Boolean | Metric | Identifies when a viewer abandons the video because it is taking too long to load |
player_software | Text | Filter | Player Software being used to play the Video (e.g. Video.js, JW Player, etc.) |
player_error_code | Integer | View | Error Code Number that identifies a fatal error (i.e. results in playback failure) being fired by the player |
video_variant_id | Unique ID | API | (Custom Metadata) Your internal ID for a video variant |
view_total_upscaling | Milliseconds | API | Internal number used to calculate Upscale Percentage Metric. Upscale Percentage = view_total_upscaling / view_total_content_playback_time |
request_latency (view_average_request_latency) | Milliseconds | Metric | Measures the average time to first byte for media requests |
player_source_url | URL | View | Video Source URL |
time_to_first_frame | Milliseconds | Metric | (Video Startup Time on Mux Dashboards) Measures from when the player has been instructed to play the video, to when the first frame of video (either content or preroll ad) is showing and the playhead is progressing. |
viewer_user_agent | Text | API | User-Agent (e.g. Mozilla/5.0 (Windows NT 10.0; WOW64; Trident/7.0; rv:11.0)) |
player_height | Integer | View | Height of the player as displayed in page, in pixels |
player_preload | Boolean | View | Specifies if the player was configured to load the video when the page loads. |
mux_viewer_id | Unique ID | View | A Mux Internal ID representing the viewer who is watching the stream. |
viewer_os_architecture | Text | API | Operating System Architecture (32bits or 64bits) |
page_load_time | Milliseconds | Metric | Measures the time from the initial user request for a page to the time when the video player is first initialized |
country_name | Text | UI | Country of the viewer |
player_source_duration | Milliseconds | View | Video Source Duration |
mux_embed_version | API | View | Internal version of beacon formatting - ignore |
view_total_content_playback_time | Milliseconds | API | Internal metric used in calculating upscale and downscale percentages. |
player_error_message | Text | View | Message sent by the player when an error has been fired up (associated with an error code) |
longitude | Degrees | View | Longitude of the viewer, truncated to one decimal place |
request_throughput (view_average_request_throughput) | bits/sec | Metric | Measures the average throughput, in bits per second, for all media requests that were completed |
video_title | Text | Filter | (Custom Metadata) Video Title |
error_type (error_type_id) | Unique ID | Mux-internal ID used to categorize errors. | |
page_url | URL | View | Page URL |
video_id | Unique ID | API | (Custom Metadata) Your internal ID for the video |
requests_for_first_preroll | Integer | Metric | Measures the number of ad requests that are made up to the point of preroll ad playback beginning |
view_seek_duration | Milliseconds | API | Total amount of time spent waiting for playback to resume after the viewer seeks to a new location. Seek Latency metric in the Dashboard is this value divided by view_seek_count |
player_source_domain | Text | API | Video Source Domain (e.g. myvideostreams.com) |
watched | Boolean | API | Ignore |
viewer_device_manufacturer | Text | View | Device Manufacturer (e.g. Apple, Microsoft) |
viewer_device_name | Text | View | Device Name (i.e. iPhone) |
player_name | Text | Filter | (Custom Metadata) Identifies different configurations or types of players around your site or application |
watch_time | Milliseconds | View | Total Watch Time across the view (includes Startup Time, Playing time, potential rebuffering) |
source_type (player_source_type) | Text | View | Format of the source, as determined by the player. E.g. 'dash', 'x-application/mpegUrl', 'mp4', etc. |
rebuffer_count (buffering_count) | Integer | Metric | Number of rebuffering events that happen during the video view. |
source_hostname (player_source_host_name) | Text | API | Video Hostname (e.g. media.myvideos.com) |
player_version | Text | Filter | (Custom Metadata) As you make changes to your player you can compare how new versions of your player perform by updating this value. This is not the player software version (e.g. Video.js 5.0.0), which is tracked automatically by the SDK. |
viewer_user_id | Unique ID | View | (Custom Metadata) A Customer-defined ID representing the viewer who is watching the stream. |
view_end | Time | API | Date and Time at which the view ended. |
used_fullscreen | Boolean | View | Indicates whether the viewer used full screen to watch the video. |
continent_code | ISO Code | API | 2-letter ISO code identifying the Continent of the viewer (e.g. NA, EU) |
player_software_version | Text | Filter | Player Software Version (e.g. 2.45.5) |
view_start | Time | API | Date and Time at which the view started. |
session_id | Unique ID | View | Mux Session ID tracking a viewer's session |
stream_type (video_stream_type) | Text | Filter | (Custom Metadata) 'live' or 'on-demand' |
video_series | Text | Filter | (Custom Metadata) example: 'Season 1' |
mux_api_version | Text | View | Internal version of beacon formatting - ignore |