Mux

Mux Metrics API

Historical metrics are used for tracking KPIs, diagnosing issues, and measuring viewers' quality of experience. Metrics are calculated using the video views that have been completed and are bucketed on the view end time for quality of experience metrics and view start time for engagement metrics. Historical metrics provide a large collection of dimensions that can be used to aggregate quality of experience based on view metadata. You can also easily compare experiences across viewer populations to, for example, find issues with specific devices or geographies. Historical metrics are similar but not directly comparable to the real-time metrics in the Real-time APIs. These metrics are aggregated for long-term storage historical reporting and are generated using different viewer populations.

GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /data/v1/metrics/{METRIC_ID}/breakdown Break a metric down by a dimension · List Breakdown Values #
Ask an LLM
“Which countries have the worst rebuffering on my videos?”
“Can I group a quality metric by browser or device over a timeframe?”
Tell an agent
Break down metric {metric_id} by {group_by}.
Show metric {metric_id} grouped by {group_by} over {timeframe}, sorted by {order_by}.
GET /data/v1/metrics/{METRIC_ID}/overall Get a metric's overall value · Get Overall Values #
Ask an LLM
“What's my overall video startup time compared to the Mux global average?”
“How many total views and watch time went into a metric's overall score?”
Tell an agent
Get the overall value of metric {metric_id}.
Show the overall {measurement} of metric {metric_id} over {timeframe}.
GET /data/v1/metrics/{METRIC_ID}/insights Find what hurts a metric most · List Insights #
Ask an LLM
“Which segments of my audience are dragging down playback quality the most?”
“What are the worst-performing values for a metric across all breakdowns?”
Tell an agent
List insights for metric {metric_id}.
Show the worst-performing breakdowns for metric {metric_id} over {timeframe}.
GET /data/v1/metrics/{METRIC_ID}/timeseries Chart a metric over time · Get Metric Timeseries Data #
Ask an LLM
“How has my rebuffer percentage trended over the past week?”
“Can I get a metric's values bucketed by hour or day?”
Tell an agent
Get timeseries data for metric {metric_id}.
Chart metric {metric_id} over {timeframe} grouped by {group_by}.
GET /data/v1/metrics/comparison Compare all metrics for one dimension value · List All Metric Values #
Ask an LLM
“For a single browser or country, what do all my quality metrics look like?”
“Can I compare every metric's value for one dimension value side by side?”
Tell an agent
List all metric values where {dimension} is {value}.
Compare every metric for {dimension} {value} over {timeframe}.

Documentation

📖
Documentation
https://www.mux.com/docs/core/stream-video-files
📖
APIReference
https://www.mux.com/docs/api-reference
📖
Documentation
https://www.mux.com/docs/guides/start-live-streaming
📖
APIReference
https://www.mux.com/docs/api-reference#tag/Live-Streams
📖
Documentation
https://www.mux.com/docs/core/monitor-your-video-streaming-performance
📖
APIReference
https://www.mux.com/docs/api-reference#tag/Video-Views
📖
Documentation
https://www.mux.com/docs/guides/play-your-videos
📖
APIReference
https://www.mux.com/docs/api-reference#tag/Streaming
📖
Documentation
https://www.mux.com/docs/guides/get-images-from-a-video
📖
APIReference
https://www.mux.com/docs/api-reference#tag/Thumbnails
📖
Documentation
https://www.mux.com/docs/guides/mux-robots
📖
APIReference
https://www.mux.com/docs/api-reference#tag/Jobs
📖
Documentation
https://www.mux.com/docs/guides/signing-jwts
📖
APIReference
https://www.mux.com/docs/api-reference#tag/Signing-Keys

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/mux-com/refs/heads/main/openapi/mux-com-metrics-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/mux-com:mux-com-metrics-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mux-com-metrics-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Mux Metrics API
  description: Mux is how developers build online video. This API encompasses both Mux Video and Mux Data functionality to help you build your video-related projects better and faster than ever before.
  version: v1
  contact:
    name: Mux DevEx
    url: https://docs.mux.com
    email: devex@mux.com
servers:
- url: https://api.mux.com
  description: Mux Production API
- url: https://image.mux.com
- url: https://stream.mux.com
- url: https://stats.mux.com
tags:


# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/mux-com/refs/heads/main/openapi/mux-com-metrics-api-openapi.yml