Matomo

Matomo Media Analytics API

Exposes Media Analytics reports for video and audio plays, engagement, resources, and player usage. Includes real-time endpoints for recent activity and archive-backed endpoints for aggregated media reports.

GitHub OpenAPI

Operations 14

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 /index.php?module=API&method=MediaAnalytics.get Get the media analytics overview · Media analytics get #
Ask an LLM
“How many video and audio plays did my site get last week?”
“What are the headline media engagement numbers for a period?”
Tell an agent
Get the media analytics overview for site {idSite} for {period} {date}.
Show only the columns {columns} of the media overview for site {idSite}, {date} by {period}.
GET /index.php?module=API&method=MediaAnalytics.getCurrentNumPlays Count media plays in the last few minutes · Media analytics get current num plays #
Ask an LLM
“How many videos or audio files are being played on my site right now?”
“What's the real-time play count for the last half hour?”
Tell an agent
Count media plays on site {idSite} in the last {lastMinutes} minutes.
Tell me the live number of plays for site {idSite} over the past {lastMinutes} minutes in segment {segment}.
GET /index.php?module=API&method=MediaAnalytics.getCurrentSumTimeSpent Get total watch time in the last few minutes · Media analytics get current sum time spent #
Ask an LLM
“How much total time have visitors spent watching media in the last hour?”
“What is the real-time sum of seconds watched on my site?”
Tell an agent
Get total seconds of media watched on site {idSite} in the last {lastMinutes} minutes.
Sum the live watch time for site {idSite} across the past {lastMinutes} minutes.
GET /index.php?module=API&method=MediaAnalytics.getCurrentMostPlays List the most played media right now · Media analytics get current most plays #
Ask an LLM
“Which videos are trending on my site in the last few minutes?”
“What are the top played media items in real time?”
Tell an agent
List the most played media on site {idSite} in the last {lastMinutes} minutes.
Show the top {filter_limit} trending media items on site {idSite} from the past {lastMinutes} minutes.
GET /index.php?module=API&method=MediaAnalytics.getVideoResources Report on video resource URLs · Media analytics get video resources #
Ask an LLM
“Which video file URLs were played most on my site?”
“Can I see video plays broken down by the media resource URL?”
Tell an agent
Report video plays by resource URL for site {idSite}, {period} {date}.
Show a flat list of video resource URLs for site {idSite} in {date} ({period}) with flat={flat}.
GET /index.php?module=API&method=MediaAnalytics.getAudioResources Report on audio resource URLs · Media analytics get audio resources #
Ask an LLM
“Which audio file URLs were played most on my site?”
“Can I see podcast or audio plays broken down by resource URL?”
Tell an agent
Report audio plays by resource URL for site {idSite}, {period} {date}.
Show a flat list of audio resource URLs for site {idSite} in {date} ({period}) with flat={flat}.
GET /index.php?module=API&method=MediaAnalytics.getVideoTitles Report video performance by title · Media analytics get video titles #
Ask an LLM
“Which video titles got the most plays and engagement?”
“What are the metrics for each video by its title?”
Tell an agent
Show video titles with their metrics for site {idSite}, {period} {date}.
Rank videos by title on site {idSite} for {date} ({period}) with secondary dimension {secondaryDimension}.
GET /index.php?module=API&method=MediaAnalytics.getAudioTitles Report audio performance by title · Media analytics get audio titles #
Ask an LLM
“Which audio titles or podcast episodes got the most listens?”
“What are the metrics for each audio track by its title?”
Tell an agent
Show audio titles with their metrics for site {idSite}, {period} {date}.
Rank audio tracks by title on site {idSite} for {date} ({period}) with secondary dimension {secondaryDimension}.
GET /index.php?module=API&method=MediaAnalytics.getGroupedVideoResources Report video plays by grouped resource URL · Media analytics get grouped video resources #
Ask an LLM
“Can I see video resource URLs grouped together instead of one row per file?”
“What are the aggregated metrics for grouped video resources?”
Tell an agent
Show grouped video resource URLs with metrics for site {idSite}, {period} {date}.
Aggregate video plays by grouped resource on site {idSite} in {date} ({period}) for segment {segment}.
GET /index.php?module=API&method=MediaAnalytics.getGroupedAudioResources Report audio plays by grouped resource URL · Media analytics get grouped audio resources #
Ask an LLM
“Is there a rolled-up view of audio file URLs rather than a row for each one?”
“What are the aggregated metrics for grouped audio resources?”
Tell an agent
Show grouped audio resource URLs with metrics for site {idSite}, {period} {date}.
Aggregate audio plays by grouped resource on site {idSite} in {date} ({period}) for segment {segment}.
GET /index.php?module=API&method=MediaAnalytics.getVideoHours Show video plays by hour of day · Media analytics get video hours #
Ask an LLM
“At what time of day do visitors watch the most videos?”
“Which hours see the highest video plays?”
Tell an agent
Break down video plays by hour for site {idSite}, {period} {date}.
Show hourly video viewing on site {idSite} for {date} ({period}).
GET /index.php?module=API&method=MediaAnalytics.getAudioHours Show audio plays by hour of day · Media analytics get audio hours #
Ask an LLM
“At what time of day do visitors listen to the most audio?”
“Which hours see the highest audio plays?”
Tell an agent
Break down audio plays by hour for site {idSite}, {period} {date}.
Show hourly audio listening on site {idSite} for {date} ({period}).
GET /index.php?module=API&method=MediaAnalytics.getVideoResolutions Show video plays by player resolution · Media analytics get video resolutions #
Ask an LLM
“What player sizes are my videos watched at?”
“Do people watch my videos in full HD or smaller embeds?”
Tell an agent
Show video plays grouped by player resolution for site {idSite}, {period} {date}.
Break down video viewing on site {idSite} by player dimensions for {date} ({period}).
GET /index.php?module=API&method=MediaAnalytics.getPlayers Show media plays by player name · Media analytics get players #
Ask an LLM
“Which media players are used to play content on my site?”
“How are plays split between embedded players versus HTML5?”
Tell an agent
Show media plays grouped by player name for site {idSite}, {period} {date}.
List which players served media on site {idSite} in {date} ({period}).

Documentation

📖
Documentation
https://developer.matomo.org/api-reference/reporting-api
📖
Documentation
https://developer.matomo.org/api-reference/reporting-api#Live
📖
Documentation
https://developer.matomo.org/api-reference/reporting-api#Goals
📖
Documentation
https://developer.matomo.org/api-reference/reporting-api-segmentation

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/matomo/refs/heads/main/openapi/matomo-mediaanalytics-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/matomo:matomo-mediaanalytics-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

matomo-mediaanalytics-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Matomo Reporting API for plugin Media Analytics API
  version: 1.0.0
  description: Exposes Media Analytics reports for video and audio plays, engagement, resources, and player usage. Includes real-time endpoints for recent activity and archive-backed endpoints for aggregated media reports.
servers:
- url: https://demo-proxy.innocraft.cloud/
  description: Current Matomo instance
security:
- MatomoToken: []
tags:


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