Matomo

Matomo Actions API

The Actions API lets you request reports for all your Visitor Actions: Page URLs, Page titles, Events, Content Tracking, File Downloads and Clicks on external websites. For example, "getPageTitles" will return all your page titles along with standard Actions metrics for each row. It is also possible to request data for a specific Page Title with "getPageTitle" and setting the parameter pageName to the page title you wish to request. Similarly, you can request metrics for a given Page URL via "getPageUrl", a Download file via "getDownload" and an outlink via "getOutlink". Note: pageName, pageUrl, outlinkUrl, downloadUrl parameters must be URL encoded before you call the API.

GitHub OpenAPI

Operations 18

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=Actions.get Get overall action metrics for a period · Actions get #
Ask an LLM
“How many pageviews, downloads and outlinks did my site get last month?”
“What are the total action counts for a site in a date range?”
Tell an agent
Show aggregated action metrics for site {idSite} for {period} {date}.
Get only the {columns} action totals for site {idSite} in {period} {date}.
GET /index.php?module=API&method=Actions.getPageUrls Report traffic per page URL · Actions get page urls #
Ask an LLM
“Which pages on my site get the most pageviews?”
“Can I see page URL metrics as a flat list instead of folders?”
Tell an agent
Show the page URLs report for site {idSite} for {period} {date}.
List page URL metrics for site {idSite} in {period} {date}, flattened.
GET /index.php?module=API&method=Actions.getPageUrlsFollowingSiteSearch Report page URLs visited after site search · Actions get page urls following site search #
Ask an LLM
“Which pages do people open right after using my site search?”
“Where do visitors land after searching on my site, by URL?”
Tell an agent
Show page URLs viewed after an internal search on site {idSite} for {period} {date}.
List destination URLs following site search for site {idSite} in {period} {date}.
GET /index.php?module=API&method=Actions.getPageTitlesFollowingSiteSearch Report page titles visited after site search · Actions get page titles following site search #
Ask an LLM
“Which page titles do visitors view immediately after searching my site?”
“What content do searchers go to next, by page title?”
Tell an agent
Show page titles viewed after an internal search on site {idSite} for {period} {date}.
List page titles that followed site search for site {idSite} in {period} {date}.
GET /index.php?module=API&method=Actions.getEntryPageUrls Report entry page URLs · Actions get entry page urls #
Ask an LLM
“Which URLs do visitors land on first when they arrive?”
“What are my top landing page URLs this week?”
Tell an agent
Show entry page URLs for site {idSite} for {period} {date}.
List every landing page URL with its metrics for site {idSite} in {period} {date}.
GET /index.php?module=API&method=Actions.getExitPageUrls Report exit page URLs · Actions get exit page urls #
Ask an LLM
“Which page URLs do visitors leave my site from?”
“Where are people exiting the site most often, by URL?”
Tell an agent
Show exit page URLs for site {idSite} for {period} {date}.
List the URLs visitors exit from on site {idSite} in {period} {date}.
GET /index.php?module=API&method=Actions.getPageUrl Get metrics for one page URL · Actions get page url #
Ask an LLM
“How many views did one specific page URL get?”
“What is the time on page for a single URL last month?”
Tell an agent
Get metrics for page URL {pageUrl} on site {idSite} for {period} {date}.
Show pageviews and time on page for {pageUrl} on site {idSite} in {period} {date}.
GET /index.php?module=API&method=Actions.getPageTitles Report traffic per page title · Actions get page titles #
Ask an LLM
“Which page titles get the most views on my site?”
“Can I see pageviews grouped by page title rather than URL?”
Tell an agent
Show the page titles report for site {idSite} for {period} {date}.
List page title metrics for site {idSite} in {period} {date}, flattened.
GET /index.php?module=API&method=Actions.getEntryPageTitles Report entry page titles · Actions get entry page titles #
Ask an LLM
“Which page titles do visitors see first when entering the site?”
“What are my top landing pages by title?”
Tell an agent
Show entry page titles for site {idSite} for {period} {date}.
List landing page titles for site {idSite} in {period} {date}.
GET /index.php?module=API&method=Actions.getExitPageTitles Report exit page titles · Actions get exit page titles #
Ask an LLM
“Which page titles are visitors on when they leave?”
“What are the most common exit pages by title?”
Tell an agent
Show exit page titles for site {idSite} for {period} {date}.
List the page titles people exit from on site {idSite} in {period} {date}.
GET /index.php?module=API&method=Actions.getPageTitle Get metrics for one page title · Actions get page title #
Ask an LLM
“How did one particular page title perform last week?”
“What are the stats for a single named page?”
Tell an agent
Get metrics for page title {pageName} on site {idSite} for {period} {date}.
Show views for the page titled {pageName} on site {idSite} in {period} {date}.
GET /index.php?module=API&method=Actions.getDownloads Report file downloads · Actions get downloads #
Ask an LLM
“Which files are downloaded most from my site?”
“How many downloads did each file get this month?”
Tell an agent
Show the downloads report for site {idSite} for {period} {date}.
List every downloaded file for site {idSite} in {period} {date}.
GET /index.php?module=API&method=Actions.getDownload Get metrics for one download URL · Actions get download #
Ask an LLM
“How many times was a specific PDF downloaded?”
“What are the download stats for one file URL?”
Tell an agent
Get download metrics for {downloadUrl} on site {idSite} for {period} {date}.
Show how often {downloadUrl} was downloaded from site {idSite} in {period} {date}.
GET /index.php?module=API&method=Actions.getSiteSearchKeywords Report site search keywords with results · Actions get site search keywords #
Ask an LLM
“What are visitors searching for on my site?”
“Which internal search terms return results most often?”
Tell an agent
Show site search keywords for site {idSite} for {period} {date}.
List the internal search terms visitors used on site {idSite} in {period} {date}.
GET /index.php?module=API&method=Actions.getSiteSearchNoResultKeywords Report site searches with no results · Actions get site search no result keywords #
Ask an LLM
“Which searches on my site come back empty?”
“What content are people looking for that my site doesn't have?”
Tell an agent
Show site search keywords with no results for site {idSite} for {period} {date}.
List zero-result internal searches on site {idSite} in {period} {date}.
GET /index.php?module=API&method=Actions.getSiteSearchCategories Report site search categories · Actions get site search categories #
Ask an LLM
“Which search categories do visitors pick when searching my site?”
“How is internal search usage split by category?”
Tell an agent
Show site search categories for site {idSite} for {period} {date}.
List internal search categories used on site {idSite} in {period} {date}.

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-actions-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-actions-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-actions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Matomo Reporting API for plugin Actions API
  version: 1.0.0
  description: 'The Actions API lets you request reports for all your Visitor Actions: Page URLs, Page titles, Events, Content Tracking, File Downloads and Clicks on external websites.'
servers:
- url: https://demo-proxy.innocraft.cloud/
  description: Current Matomo instance
security:
- MatomoToken: []
tags:


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