Matomo

Matomo Marketing Campaigns Reporting API

Exposes reporting API endpoints for marketing campaign dimensions and drill-down reports. Includes campaign IDs, names, keywords, source and medium dimensions, and hierarchical subtables.

GitHub OpenAPI
Business capability
Marketing Management BC-400

Operations 11

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=MarketingCampaignsReporting.getId Report campaign performance by campaign ID · Marketing campaigns reporting get id #
Ask an LLM
“How are my campaigns performing when grouped by campaign ID?”
“Can I see visits and conversions per utm_id value?”
Tell an agent
Get campaign metrics by campaign ID for site {idSite}, {period} {date}.
Break down campaign traffic by ID on site {idSite} for {period} {date}, segment {segment}.
GET /index.php?module=API&method=MarketingCampaignsReporting.getName Report campaign performance by campaign name · Marketing campaigns reporting get name #
Ask an LLM
“Which marketing campaign brought the most visits last month in Matomo?”
“Can I get campaign names with their keyword and content rows expanded?”
Tell an agent
Get campaign metrics by campaign name for site {idSite}, {period} {date}.
List campaign names for site {idSite}, {period} {date}, flattened with their subtables.
GET /index.php?module=API&method=MarketingCampaignsReporting.getKeywordContentFromNameId Drill into one campaign's keywords and content · Marketing campaigns reporting get keyword content from name id #
Ask an LLM
“For one specific campaign, which keywords and ad content drove traffic?”
“Can I drill into a campaign name row to see its keyword breakdown?”
Tell an agent
Get keyword and content rows for campaign subtable {idSubtable} on site {idSite}, {period} {date}.
Drill into campaign row {idSubtable} for site {idSite} ({period} {date}) to show its keywords.
GET /index.php?module=API&method=MarketingCampaignsReporting.getKeyword Report campaign performance by keyword · Marketing campaigns reporting get keyword #
Ask an LLM
“Which campaign keywords (utm_term) bring the best traffic across all campaigns?”
“What are the top campaign keywords this week?”
Tell an agent
Get campaign metrics by keyword for site {idSite}, {period} {date}.
Rank all campaign keywords on site {idSite} for {period} {date}.
GET /index.php?module=API&method=MarketingCampaignsReporting.getSource Report campaign performance by source · Marketing campaigns reporting get source #
Ask an LLM
“Which campaign sources like newsletter or facebook send the most visitors?”
“Can I compare utm_source values for my campaigns?”
Tell an agent
Get campaign metrics by source for site {idSite}, {period} {date}.
Show campaign traffic per utm_source on site {idSite} for {period} {date}.
GET /index.php?module=API&method=MarketingCampaignsReporting.getMedium Report campaign performance by medium · Marketing campaigns reporting get medium #
Ask an LLM
“Does email or cpc perform better as a campaign medium?”
“Can I see results grouped by utm_medium on its own?”
Tell an agent
Get campaign metrics by medium for site {idSite}, {period} {date}.
Compare campaign mediums on site {idSite} for {period} {date}.
GET /index.php?module=API&method=MarketingCampaignsReporting.getContent Report campaign performance by content · Marketing campaigns reporting get content #
Ask an LLM
“Which ad variation or link (utm_content) got the most clicks across campaigns?”
“How do I compare different campaign creatives?”
Tell an agent
Get campaign metrics by content for site {idSite}, {period} {date}.
Show performance of each campaign content variant on site {idSite}, {period} {date}.
GET /index.php?module=API&method=MarketingCampaignsReporting.getGroup Report campaign performance by group · Marketing campaigns reporting get group #
Ask an LLM
“How do my campaign groups compare against each other?”
“Can I roll up campaign results by the utm group parameter?”
Tell an agent
Get campaign metrics by group for site {idSite}, {period} {date}.
Show campaign group results for site {idSite} over {period} {date}.
GET /index.php?module=API&method=MarketingCampaignsReporting.getPlacement Report campaign performance by placement · Marketing campaigns reporting get placement #
Ask an LLM
“Which ad placements are sending the best campaign traffic?”
“Can I see campaign metrics broken down by placement?”
Tell an agent
Get campaign metrics by placement for site {idSite}, {period} {date}.
Compare ad placements for campaigns on site {idSite}, {period} {date}.
GET /index.php?module=API&method=MarketingCampaignsReporting.getSourceMedium Report campaigns by source and medium pairs · Marketing campaigns reporting get source medium #
Ask an LLM
“What do my campaigns look like as source / medium combinations?”
“Can I see a source-medium report with campaign names nested underneath?”
Tell an agent
Get the campaign source / medium report for site {idSite}, {period} {date}.
Show source-medium pairs for site {idSite}, {period} {date}, expanded to include campaign names.
GET /index.php?module=API&method=MarketingCampaignsReporting.getNameFromSourceMediumId Drill into campaign names for a source/medium · Marketing campaigns reporting get name from source medium id #
Ask an LLM
“Which campaigns are behind one specific source and medium pair?”
“Can I expand a source-medium row to see campaign names?”
Tell an agent
Get campaign names for source/medium subtable {idSubtable} on site {idSite}, {period} {date}.
Drill into source-medium row {idSubtable} on site {idSite} ({period} {date}) to list its campaigns.

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-marketingcampaignsreporting-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-marketingcampaignsreporting-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-marketingcampaignsreporting-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Matomo Reporting API for plugin Marketing Campaigns…
  version: 1.0.0
  description: Exposes reporting API endpoints for marketing campaign dimensions and drill-down reports. Includes campaign IDs, names, keywords, source and medium dimensions, and hierarchical subtables.
servers:
- url: https://demo-proxy.innocraft.cloud/
  description: Current Matomo instance
security:
- MatomoToken: []
tags:


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