Matomo
Matomo is an open source web analytics platform — self-hosted (Matomo On-Premise) or vendor-hosted (Matomo Cloud) — that gives an organisation complete ownership of its analytics data. Formerly Piwik, it is the leading privacy-first alternative to Google Analytics, with GDPR tooling, data residency in Frankfurt for Cloud, and no data sampling. Its API surface is substantial and unusual: 556 documented operations across 59 plugin modules, every one dispatched through a single /index.php RPC entrypoint on the customer's own deployment rather than a vendor host, plus a separate tracking entrypoint at /matomo.php. Matomo generates its own OpenAPI 3.1.0 documents through a first-party ApiReference plugin, and ships a first-party Model Context Protocol server exposing 19 agent tools over an authenticated HTTP endpoint.
Matomo publishes 61 APIs on the APIs.io network, including Live API, Goals API, Segments API, and 58 more. Tagged areas include Analytics, Web Analytics, Open-Source, Privacy, and Data Ownership.
Matomo’s developer surface includes authentication, changelog, CLI, sandbox, documentation, API reference, getting-started guide, and 43 more developer resources.
61 APIs
1 MCP Servers
Individual APIs this provider publishes, each with its own machine-readable definition.
The Matomo Live API exposes 6 operations of the Matomo Reporting API (module `Live`). Real-time visitor data: live counters, the most recent visits in full detail, and individua...
The Matomo Goals API exposes 11 operations of the Matomo Reporting API (module `Goals`). Conversion goal management and goal reporting — create, update and delete goals, and rea...
The Matomo SegmentEditor API exposes 9 operations of the Matomo Reporting API (module `SegmentEditor`). Saved segment management — the reusable filter definitions that can be ap...
The single /index.php dispatch entrypoint through which every Matomo Reporting API method is invoked, by supplying module=API and method=Module.Action. This entry documents the ...
The Matomo Tracking API — the server-side ingest entrypoint at /matomo.php that records pageviews, events, goals, ecommerce orders, site searches and content interactions. It is...
The Matomo SitesManager API exposes 53 operations of the Matomo Reporting API (module `SitesManager`). Site provisioning and configuration — add, update and delete tracked sites...
The Matomo TagManager API exposes 47 operations of the Matomo Reporting API (module `TagManager`). Matomo Tag Manager — containers, versions, tags, triggers and variables, plus ...
The Matomo UsersManager API exposes 32 operations of the Matomo Reporting API (module `UsersManager`). User and permission administration — create, invite, update and delete Mat...
The Matomo CrashAnalytics API exposes 31 operations of the Matomo Reporting API (module `CrashAnalytics`). JavaScript crash tracking — crash groups, messages, sources, and which...
The Matomo HeatmapSessionRecording API exposes 31 operations of the Matomo Reporting API (module `HeatmapSessionRecording`). Heatmaps and session recordings — configure them, re...
The Matomo FormAnalytics API exposes 26 operations of the Matomo Reporting API (module `FormAnalytics`). Form performance analytics — entry and drop-off fields, field timings, c...
The Matomo Referrers API exposes 23 operations of the Matomo Reporting API (module `Referrers`). Where traffic came from: referrer type, search engines, keywords, campaigns, web...
The Matomo Funnels API exposes 19 operations of the Matomo Reporting API (module `Funnels`). Conversion funnel definition and analysis — flow, entries, exits and step-level drop...
The Matomo Actions API exposes 18 operations of the Matomo Reporting API (module `Actions`). Page, entry page, exit page, page title, download, outlink and site-search reporting...
The Matomo API API exposes 17 operations of the Matomo Reporting API (module `API`). Matomo core meta-API: version and environment info, the machine-readable report and segment ...
The Matomo AbTesting API exposes 17 operations of the Matomo Reporting API (module `AbTesting`). A/B test experiment management and results reporting. Every operation is dispatc...
The Matomo MediaAnalytics API exposes 14 operations of the Matomo Reporting API (module `MediaAnalytics`). Video and audio engagement analytics: plays, finishes, play time and a...
The Matomo CustomReports API exposes 13 operations of the Matomo Reporting API (module `CustomReports`). Build and read custom report definitions combining arbitrary dimensions ...
The Matomo MobileMessaging API exposes 12 operations of the Matomo Reporting API (module `MobileMessaging`). SMS delivery configuration and phone-number verification for schedul...
The Matomo SearchEngineKeywordsPerformance API exposes 12 operations of the Matomo Reporting API (module `SearchEngineKeywordsPerformance`). Real search keyword data imported fr...
The Matomo MarketingCampaignsReporting API exposes 11 operations of the Matomo Reporting API (module `MarketingCampaignsReporting`). Extended campaign reporting across campaign ...
The Matomo VisitsSummary API exposes 10 operations of the Matomo Reporting API (module `VisitsSummary`). The core traffic overview — visits, unique visitors, users, actions, bou...
The Matomo Events API exposes 9 operations of the Matomo Reporting API (module `Events`). Custom event reporting by category, action and name, with the full set of secondary-dim...
The Matomo LanguagesManager API exposes 9 operations of the Matomo Reporting API (module `LanguagesManager`). Language and translation operations for the Matomo interface. Every...
The Matomo DevicesDetection API exposes 8 operations of the Matomo Reporting API (module `DevicesDetection`). Device type, brand, model, operating system, browser and browser-en...
The Matomo OAuth2 API exposes 8 operations of the Matomo Reporting API (module `OAuth2`). OAuth 2.0 client administration for the instance (superuser only). Every operation is d...
The Matomo UserCountry API exposes 8 operations of the Matomo Reporting API (module `UserCountry`). Geolocation reporting: country, continent, region and city. Every operation i...
The Matomo Annotations API exposes 7 operations of the Matomo Reporting API (module `Annotations`). Dated notes attached to a site so report readers can see what happened on a g...
The Matomo CustomAlerts API exposes 7 operations of the Matomo Reporting API (module `CustomAlerts`). Threshold alerts on any report metric, with triggered-alert history. Every ...
The Matomo AdvertisingConversionExport API exposes 6 operations of the Matomo Reporting API (module `AdvertisingConversionExport`). Export conversions back out to advertising pl...
The Matomo CustomDimensions API exposes 6 operations of the Matomo Reporting API (module `CustomDimensions`). Configure and read custom dimensions in visit or action scope. Ever...
The Matomo PrivacyManager API exposes 6 operations of the Matomo Reporting API (module `PrivacyManager`). GDPR operations — find and export or delete a data subject, manage anon...
The Matomo ScheduledReports API exposes 6 operations of the Matomo Reporting API (module `ScheduledReports`). Create, update and send scheduled email and SMS reports. Every oper...
The Matomo Dashboard API exposes 5 operations of the Matomo Reporting API (module `Dashboard`). Dashboard layout and widget management. Every operation is dispatched through the...
The Matomo Insights API exposes 5 operations of the Matomo Reporting API (module `Insights`). Automatic movers-and-shakers analysis — which report rows changed most between two ...
The Matomo Transitions API exposes 4 operations of the Matomo Reporting API (module `Transitions`). What visitors did immediately before and after a given page or page title. Ev...
The Matomo VisitorInterest API exposes 4 operations of the Matomo Reporting API (module `VisitorInterest`). Visitor engagement: visit duration, pages per visit, visits per visit...
The Matomo ActivityLog API exposes 3 operations of the Matomo Reporting API (module `ActivityLog`). Audit log of who changed what inside Matomo. Every operation is dispatched th...
The Matomo ApiReference API exposes 3 operations of the Matomo Reporting API (module `ApiReference`). Reads the OpenAPI 3.1.0 documents Matomo generates for each installed plugi...
The Matomo CoreAdminHome API exposes 3 operations of the Matomo Reporting API (module `CoreAdminHome`). Instance administration operations, including tracking-failure inspection...
The Matomo Feedback API exposes 3 operations of the Matomo Reporting API (module `Feedback`). In-product feedback and survey operations. Every operation is dispatched through th...
The Matomo MultiSites API exposes 3 operations of the Matomo Reporting API (module `MultiSites`). Cross-site rollup — the All Websites dashboard, with metrics for every site the...
The Matomo RollUpReporting API exposes 3 operations of the Matomo Reporting API (module `RollUpReporting`). Roll-up sites that aggregate the data of several other sites into one...
The Matomo Tour API exposes 3 operations of the Matomo Reporting API (module `Tour`). Product onboarding tour and challenge progress. Every operation is dispatched through the s...
The Matomo VisitTime API exposes 3 operations of the Matomo Reporting API (module `VisitTime`). Visits by server time, local time and day of week. Every operation is dispatched ...
The Matomo Cohorts API exposes 2 operations of the Matomo Reporting API (module `Cohorts`). Cohort retention analysis. Every operation is dispatched through the single `/index.p...
The Matomo Contents API exposes 2 operations of the Matomo Reporting API (module `Contents`). Content impression and interaction reporting for content blocks and pieces. Every o...
The Matomo Marketplace API exposes 2 operations of the Matomo Reporting API (module `Marketplace`). Access to the Matomo plugin marketplace from inside an instance. Every operat...
The Matomo Overlay API exposes 2 operations of the Matomo Reporting API (module `Overlay`). Page Overlay support operations, which render analytics on top of the live site. Ever...
The Matomo Resolution API exposes 2 operations of the Matomo Reporting API (module `Resolution`). Screen resolution and configuration reporting. Every operation is dispatched th...
The Matomo UserLanguage API exposes 2 operations of the Matomo Reporting API (module `UserLanguage`). Visitor browser language reporting. Every operation is dispatched through t...
The Matomo Bandwidth API exposes 1 operations of the Matomo Reporting API (module `Bandwidth`). Bandwidth consumption reporting. Every operation is dispatched through the single...
The Matomo CustomJsTracker API exposes 1 operations of the Matomo Reporting API (module `CustomJsTracker`). Access to the generated JavaScript tracker file. Every operation is d...
The Matomo DevicePlugins API exposes 1 operations of the Matomo Reporting API (module `DevicePlugins`). Browser plugin detection reporting. Every operation is dispatched through...
The Matomo ImageGraph API exposes 1 operations of the Matomo Reporting API (module `ImageGraph`). Static PNG chart rendering of any Matomo report, for embedding in email and PDF...
The Matomo Login API exposes 1 operations of the Matomo Reporting API (module `Login`). Authentication-related operations exposed by the login module. Every operation is dispatc...
The Matomo PagePerformance API exposes 1 operations of the Matomo Reporting API (module `PagePerformance`). Page-load timing reporting: network, server, transfer, DOM processing...
The Matomo SEO API exposes 1 operations of the Matomo Reporting API (module `SEO`). SEO ranking metrics for a URL. Every operation is dispatched through the single `/index.php?m...
The Matomo TwoFactorAuth API exposes 1 operations of the Matomo Reporting API (module `TwoFactorAuth`). Two-factor authentication operations. Every operation is dispatched throu...
The Matomo UserId API exposes 1 operations of the Matomo Reporting API (module `UserId`). Reporting by the User ID assigned to a logged-in visitor. Every operation is dispatched...
The Matomo VisitFrequency API exposes 1 operations of the Matomo Reporting API (module `VisitFrequency`). Returning-visitor metrics. Every operation is dispatched through the si...
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
Model Context Protocol servers that expose these APIs to AI agents.
Published pricing tiers and plan structures.
Documented rate limits and quota policies.
Cost, billing, and metering signals for API financial operations.
Authentication, domain security, vulnerability disclosure, and trust-center signals.
OAuth scopes governing access to this provider's APIs.
Recommended x-agentic-access execution contracts for AI agents.
aid: matomo
name: Matomo
description: 'Matomo is an open source web analytics platform — self-hosted (Matomo On-Premise) or vendor-hosted (Matomo Cloud)
— that gives an organisation complete ownership of its analytics data. Formerly Piwik, it is the leading privacy-first alternative
to Google Analytics, with GDPR tooling, data residency in Frankfurt for Cloud, and no data sampling. Its API surface is
substantial and unusual: 556 documented operations across 59 plugin modules, every one dispatched through a single /index.php
RPC entrypoint on the customer''s own deployment rather than a vendor host, plus a separate tracking entrypoint at /matomo.php.
Matomo generates its own OpenAPI 3.1.0 documents through a first-party ApiReference plugin, and ships a first-party Model
Context Protocol server exposing 19 agent tools over an authenticated HTTP endpoint.'
type: Index
accessModel:
pricing: freemium
onboarding: self-serve
trial: true
try_now: true
public: true
label: Open source · Free On-Premise · Paid Cloud · Public demo instance
confidence: high
source:
- plans
- authentication
- sandbox
generated: '2026-08-13'
method: searched
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/matomo.png
tags:
- Analytics
- Web Analytics
- Open-Source
- Privacy
- Data Ownership
- Self-Hosted
- GDPR
- Tag Management
- Conversion Optimization
- MCP
tags_raw:
- Analytics
- Web Analytics
- Open Source
- Privacy
- Data Ownership
- Self-Hosted
- GDPR
- Tag Management
- Conversion Optimization
- Model Context Protocol
url: https://raw.githubusercontent.com/api-evangelist/matomo/refs/heads/main/apis.yml
created: '2026-03-26'
modified: '2026-08-13'
specificationVersion: '0.23'
apis:
- aid: matomo:live-api
name: Matomo Live API
description: 'The Matomo Live API exposes 6 operations of the Matomo Reporting API (module `Live`). Real-time visitor data:
live counters, the most recent visits in full detail, and individual visitor profiles. Every operation is dispatched through
the single `/index.php?module=API&method=Live.<Action>` entrypoint on the customer''s own Matomo instance, self-hosted
or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo''s own, generated by its first-party ApiReference plugin.'
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Real-Time
- Visitors
- Live Data
properties:
- type: OpenAPI
url: openapi/matomo-live-openapi.json
- type: Overlay
url: overlays/matomo-live-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api#Live
- aid: matomo:goals-api
name: Matomo Goals API
description: The Matomo Goals API exposes 11 operations of the Matomo Reporting API (module `Goals`). Conversion goal management
and goal reporting — create, update and delete goals, and read conversions, revenue and days/visits-to-conversion. Every
operation is dispatched through the single `/index.php?module=API&method=Goals.<Action>` entrypoint on the customer's
own Matomo instance, self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's own, generated by its first-party
ApiReference plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Conversions
- Goals
- Revenue
properties:
- type: OpenAPI
url: openapi/matomo-goals-openapi.json
- type: Overlay
url: overlays/matomo-goals-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api#Goals
- aid: matomo:segments-api
name: Matomo Segments API
description: The Matomo SegmentEditor API exposes 9 operations of the Matomo Reporting API (module `SegmentEditor`). Saved
segment management — the reusable filter definitions that can be applied to any Matomo report. Every operation is dispatched
through the single `/index.php?module=API&method=SegmentEditor.<Action>` entrypoint on the customer's own Matomo instance,
self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's own, generated by its first-party ApiReference
plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Segmentation
- Filters
- Visitors
properties:
- type: OpenAPI
url: openapi/matomo-segment-editor-openapi.json
- type: Overlay
url: overlays/matomo-segment-editor-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api-segmentation
- aid: matomo:matomo-index-php-api
name: Matomo Reporting API (index.php entrypoint)
description: The single /index.php dispatch entrypoint through which every Matomo Reporting API method is invoked, by supplying
module=API and method=Module.Action. This entry documents the entrypoint contract itself — the shared parameters (idSite,
period, date, segment, format, token_auth) and the bulk-request form — rather than any one module. The per-module contracts
are the 59 OpenAPI documents generated by Matomo's own ApiReference plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Reporting
- RPC
- Entry Point
tags_raw:
- Analytics
- Reporting
- RPC
- Entrypoint
properties:
- type: OpenAPI
url: openapi/matomo-index-php-api-openapi.yml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- type: GettingStarted
url: https://developer.matomo.org/api-reference/reporting-api-introduction
- type: APIReference
url: https://developer.matomo.org/api-reference/api
- aid: matomo:matomo-matomo-php-api
name: Matomo Tracking API (matomo.php entrypoint)
description: 'The Matomo Tracking API — the server-side ingest entrypoint at /matomo.php that records pageviews, events,
goals, ecommerce orders, site searches and content interactions. It is the counterpart to the JavaScript tracking client
and the target of every first-party tracking SDK. On Matomo Cloud the tracking endpoints are explicitly exempt from the
API rate limits that apply to reporting. There is no MCP tool for tracking: agents can read Matomo analytics but cannot
write tracking events.'
humanURL: https://developer.matomo.org/api-reference/tracking-api
baseURL: https://{matomo_host}/matomo.php
tags:
- Analytics
- Tracking
- Event
- Ingest
- Server-Side
tags_raw:
- Analytics
- Tracking
- Events
- Ingest
- Server-Side
properties:
- type: OpenAPI
url: openapi/matomo-matomo-php-api-openapi.yml
- type: Documentation
url: https://developer.matomo.org/api-reference/tracking-api
- type: SDKs
url: https://developer.matomo.org/api-reference/tracking-api-clients
- type: GettingStarted
url: https://developer.matomo.org/guides/tracking-javascript-guide
- aid: matomo:sites-manager-api
name: Matomo SitesManager API
description: The Matomo SitesManager API exposes 53 operations of the Matomo Reporting API (module `SitesManager`). Site
provisioning and configuration — add, update and delete tracked sites, retrieve JavaScript and image tracking codes, and
manage global exclusions, currencies and timezones. The largest single surface in Matomo. Every operation is dispatched
through the single `/index.php?module=API&method=SitesManager.<Action>` entrypoint on the customer's own Matomo instance,
self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's own, generated by its first-party ApiReference
plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Site Management
- Provisioning
- Tracking Code
properties:
- type: OpenAPI
url: openapi/matomo-sites-manager-openapi.json
- type: Overlay
url: overlays/matomo-sites-manager-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:tag-manager-api
name: Matomo TagManager API
description: The Matomo TagManager API exposes 47 operations of the Matomo Reporting API (module `TagManager`). Matomo Tag
Manager — containers, versions, tags, triggers and variables, plus embed codes, preview mode and container import/export.
Every operation is dispatched through the single `/index.php?module=API&method=TagManager.<Action>` entrypoint on the
customer's own Matomo instance, self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's own, generated
by its first-party ApiReference plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Tag Management
- Containers
- Triggers
properties:
- type: OpenAPI
url: openapi/matomo-tag-manager-openapi.json
- type: Overlay
url: overlays/matomo-tag-manager-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:users-manager-api
name: Matomo UsersManager API
description: The Matomo UsersManager API exposes 32 operations of the Matomo Reporting API (module `UsersManager`). User
and permission administration — create, invite, update and delete Matomo users, assign per-site roles and capabilities,
and mint app-specific auth tokens. Every operation is dispatched through the single `/index.php?module=API&method=UsersManager.<Action>`
entrypoint on the customer's own Matomo instance, self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's
own, generated by its first-party ApiReference plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- User Management
- Permissions
- Access Control
properties:
- type: OpenAPI
url: openapi/matomo-users-manager-openapi.json
- type: Overlay
url: overlays/matomo-users-manager-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:crash-analytics-api
name: Matomo CrashAnalytics API
description: The Matomo CrashAnalytics API exposes 31 operations of the Matomo Reporting API (module `CrashAnalytics`).
JavaScript crash tracking — crash groups, messages, sources, and which pages and categories crashes occur on. Every operation
is dispatched through the single `/index.php?module=API&method=CrashAnalytics.<Action>` entrypoint on the customer's own
Matomo instance, self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's own, generated by its first-party
ApiReference plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Crashes
- Error Tracking
- JavaScript
properties:
- type: OpenAPI
url: openapi/matomo-crash-analytics-openapi.json
- type: Overlay
url: overlays/matomo-crash-analytics-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:heatmap-session-recording-api
name: Matomo HeatmapSessionRecording API
description: The Matomo HeatmapSessionRecording API exposes 31 operations of the Matomo Reporting API (module `HeatmapSessionRecording`).
Heatmaps and session recordings — configure them, read recorded heatmap data, and list, fetch and delete recorded sessions.
Every operation is dispatched through the single `/index.php?module=API&method=HeatmapSessionRecording.<Action>` entrypoint
on the customer's own Matomo instance, self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's own, generated
by its first-party ApiReference plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Heatmaps
- Session Recording
- User Behavior
properties:
- type: OpenAPI
url: openapi/matomo-heatmap-session-recording-openapi.json
- type: Overlay
url: overlays/matomo-heatmap-session-recording-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:form-analytics-api
name: Matomo FormAnalytics API
description: The Matomo FormAnalytics API exposes 26 operations of the Matomo Reporting API (module `FormAnalytics`). Form
performance analytics — entry and drop-off fields, field timings, corrections and conversion rules. Every operation is
dispatched through the single `/index.php?module=API&method=FormAnalytics.<Action>` entrypoint on the customer's own Matomo
instance, self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's own, generated by its first-party ApiReference
plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Forms
- Conversion Optimization
properties:
- type: OpenAPI
url: openapi/matomo-form-analytics-openapi.json
- type: Overlay
url: overlays/matomo-form-analytics-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:referrers-api
name: Matomo Referrers API
description: 'The Matomo Referrers API exposes 23 operations of the Matomo Reporting API (module `Referrers`). Where traffic
came from: referrer type, search engines, keywords, campaigns, websites, social networks and AI assistants. Every operation
is dispatched through the single `/index.php?module=API&method=Referrers.<Action>` entrypoint on the customer''s own Matomo
instance, self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo''s own, generated by its first-party ApiReference
plugin.'
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Referrers
- Campaigns
- Search Engines
- Social
properties:
- type: OpenAPI
url: openapi/matomo-referrers-openapi.json
- type: Overlay
url: overlays/matomo-referrers-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:funnels-api
name: Matomo Funnels API
description: The Matomo Funnels API exposes 19 operations of the Matomo Reporting API (module `Funnels`). Conversion funnel
definition and analysis — flow, entries, exits and step-level drop-off. Every operation is dispatched through the single
`/index.php?module=API&method=Funnels.<Action>` entrypoint on the customer's own Matomo instance, self-hosted or on Matomo
Cloud. The OpenAPI 3.1.0 document is Matomo's own, generated by its first-party ApiReference plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Funnels
- Conversion
- Drop-Off
properties:
- type: OpenAPI
url: openapi/matomo-funnels-openapi.json
- type: Overlay
url: overlays/matomo-funnels-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:actions-api
name: Matomo Actions API
description: The Matomo Actions API exposes 18 operations of the Matomo Reporting API (module `Actions`). Page, entry page,
exit page, page title, download, outlink and site-search reporting — what visitors actually did on the site. Every operation
is dispatched through the single `/index.php?module=API&method=Actions.<Action>` entrypoint on the customer's own Matomo
instance, self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's own, generated by its first-party ApiReference
plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Pages
- Downloads
- Site Search
properties:
- type: OpenAPI
url: openapi/matomo-actions-openapi.json
- type: Overlay
url: overlays/matomo-actions-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:api-api
name: Matomo API API
description: 'The Matomo API API exposes 17 operations of the Matomo Reporting API (module `API`). Matomo core meta-API:
version and environment info, the machine-readable report and segment metadata catalogs, processed-report retrieval, row
evolution, bulk request dispatch and the glossary. Every operation is dispatched through the single `/index.php?module=API&method=API.<Action>`
entrypoint on the customer''s own Matomo instance, self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo''s
own, generated by its first-party ApiReference plugin.'
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Metadata
- Discovery
- Reporting
properties:
- type: OpenAPI
url: openapi/matomo-api-openapi.json
- type: Overlay
url: overlays/matomo-api-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:ab-testing-api
name: Matomo AbTesting API
description: The Matomo AbTesting API exposes 17 operations of the Matomo Reporting API (module `AbTesting`). A/B test experiment
management and results reporting. Every operation is dispatched through the single `/index.php?module=API&method=AbTesting.<Action>`
entrypoint on the customer's own Matomo instance, self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's
own, generated by its first-party ApiReference plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- A/B Testing
- Experiments
properties:
- type: OpenAPI
url: openapi/matomo-ab-testing-openapi.json
- type: Overlay
url: overlays/matomo-ab-testing-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:media-analytics-api
name: Matomo MediaAnalytics API
description: 'The Matomo MediaAnalytics API exposes 14 operations of the Matomo Reporting API (module `MediaAnalytics`).
Video and audio engagement analytics: plays, finishes, play time and audience watch curves. Every operation is dispatched
through the single `/index.php?module=API&method=MediaAnalytics.<Action>` entrypoint on the customer''s own Matomo instance,
self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo''s own, generated by its first-party ApiReference
plugin.'
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Video
- Audio
- Media
properties:
- type: OpenAPI
url: openapi/matomo-media-analytics-openapi.json
- type: Overlay
url: overlays/matomo-media-analytics-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:custom-reports-api
name: Matomo CustomReports API
description: The Matomo CustomReports API exposes 13 operations of the Matomo Reporting API (module `CustomReports`). Build
and read custom report definitions combining arbitrary dimensions and metrics. Every operation is dispatched through the
single `/index.php?module=API&method=CustomReports.<Action>` entrypoint on the customer's own Matomo instance, self-hosted
or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's own, generated by its first-party ApiReference plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Custom Reports
- Reporting
properties:
- type: OpenAPI
url: openapi/matomo-custom-reports-openapi.json
- type: Overlay
url: overlays/matomo-custom-reports-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:mobile-messaging-api
name: Matomo MobileMessaging API
description: The Matomo MobileMessaging API exposes 12 operations of the Matomo Reporting API (module `MobileMessaging`).
SMS delivery configuration and phone-number verification for scheduled reports. Every operation is dispatched through
the single `/index.php?module=API&method=MobileMessaging.<Action>` entrypoint on the customer's own Matomo instance, self-hosted
or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's own, generated by its first-party ApiReference plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- SMS
- Notification
tags_raw:
- Analytics
- SMS
- Notifications
properties:
- type: OpenAPI
url: openapi/matomo-mobile-messaging-openapi.json
- type: Overlay
url: overlays/matomo-mobile-messaging-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:search-engine-keywords-performance-api
name: Matomo SearchEngineKeywordsPerformance API
description: The Matomo SearchEngineKeywordsPerformance API exposes 12 operations of the Matomo Reporting API (module `SearchEngineKeywordsPerformance`).
Real search keyword data imported from Google Search Console, Bing and Yandex webmaster tools. Every operation is dispatched
through the single `/index.php?module=API&method=SearchEngineKeywordsPerformance.<Action>` entrypoint on the customer's
own Matomo instance, self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's own, generated by its first-party
ApiReference plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- SEO
- Keywords
- Search Console
properties:
- type: OpenAPI
url: openapi/matomo-search-engine-keywords-performance-openapi.json
- type: Overlay
url: overlays/matomo-search-engine-keywords-performance-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:marketing-campaigns-reporting-api
name: Matomo MarketingCampaignsReporting API
description: The Matomo MarketingCampaignsReporting API exposes 11 operations of the Matomo Reporting API (module `MarketingCampaignsReporting`).
Extended campaign reporting across campaign name, keyword, source, medium, content and id. Every operation is dispatched
through the single `/index.php?module=API&method=MarketingCampaignsReporting.<Action>` entrypoint on the customer's own
Matomo instance, self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's own, generated by its first-party
ApiReference plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Campaigns
- Attribution
- Marketing
properties:
- type: OpenAPI
url: openapi/matomo-marketing-campaigns-reporting-openapi.json
- type: Overlay
url: overlays/matomo-marketing-campaigns-reporting-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:visits-summary-api
name: Matomo VisitsSummary API
description: The Matomo VisitsSummary API exposes 10 operations of the Matomo Reporting API (module `VisitsSummary`). The
core traffic overview — visits, unique visitors, users, actions, bounces and time on site for any period. Every operation
is dispatched through the single `/index.php?module=API&method=VisitsSummary.<Action>` entrypoint on the customer's own
Matomo instance, self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's own, generated by its first-party
ApiReference plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Traffic
- Visits
- Metrics
properties:
- type: OpenAPI
url: openapi/matomo-visits-summary-openapi.json
- type: Overlay
url: overlays/matomo-visits-summary-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:events-api
name: Matomo Events API
description: The Matomo Events API exposes 9 operations of the Matomo Reporting API (module `Events`). Custom event reporting
by category, action and name, with the full set of secondary-dimension pivots. Every operation is dispatched through the
single `/index.php?module=API&method=Events.<Action>` entrypoint on the customer's own Matomo instance, self-hosted or
on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's own, generated by its first-party ApiReference plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Event
- Custom Events
tags_raw:
- Analytics
- Events
- Custom Events
properties:
- type: OpenAPI
url: openapi/matomo-events-openapi.json
- type: Overlay
url: overlays/matomo-events-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:languages-manager-api
name: Matomo LanguagesManager API
description: The Matomo LanguagesManager API exposes 9 operations of the Matomo Reporting API (module `LanguagesManager`).
Language and translation operations for the Matomo interface. Every operation is dispatched through the single `/index.php?module=API&method=LanguagesManager.<Action>`
entrypoint on the customer's own Matomo instance, self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's
own, generated by its first-party ApiReference plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Localization
- Translations
properties:
- type: OpenAPI
url: openapi/matomo-languages-manager-openapi.json
- type: Overlay
url: overlays/matomo-languages-manager-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:devices-detection-api
name: Matomo DevicesDetection API
description: The Matomo DevicesDetection API exposes 8 operations of the Matomo Reporting API (module `DevicesDetection`).
Device type, brand, model, operating system, browser and browser-engine reporting. Every operation is dispatched through
the single `/index.php?module=API&method=DevicesDetection.<Action>` entrypoint on the customer's own Matomo instance,
self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's own, generated by its first-party ApiReference
plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Devices
- Browsers
- Operating Systems
properties:
- type: OpenAPI
url: openapi/matomo-devices-detection-openapi.json
- type: Overlay
url: overlays/matomo-devices-detection-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:oauth2-api
name: Matomo OAuth2 API
description: The Matomo OAuth2 API exposes 8 operations of the Matomo Reporting API (module `OAuth2`). OAuth 2.0 client
administration for the instance (superuser only). Every operation is dispatched through the single `/index.php?module=API&method=OAuth2.<Action>`
entrypoint on the customer's own Matomo instance, self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's
own, generated by its first-party ApiReference plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Authentication
- Authorization
- Clients
tags_raw:
- Analytics
- OAuth
- Authorization
- Clients
properties:
- type: OpenAPI
url: openapi/matomo-oauth2-openapi.json
- type: Overlay
url: overlays/matomo-oauth2-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:user-country-api
name: Matomo UserCountry API
description: 'The Matomo UserCountry API exposes 8 operations of the Matomo Reporting API (module `UserCountry`). Geolocation
reporting: country, continent, region and city. Every operation is dispatched through the single `/index.php?module=API&method=UserCountry.<Action>`
entrypoint on the customer''s own Matomo instance, self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo''s
own, generated by its first-party ApiReference plugin.'
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Geolocation
- Countries
- Cities
properties:
- type: OpenAPI
url: openapi/matomo-user-country-openapi.json
- type: Overlay
url: overlays/matomo-user-country-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:annotations-api
name: Matomo Annotations API
description: The Matomo Annotations API exposes 7 operations of the Matomo Reporting API (module `Annotations`). Dated notes
attached to a site so report readers can see what happened on a given day. Every operation is dispatched through the single
`/index.php?module=API&method=Annotations.<Action>` entrypoint on the customer's own Matomo instance, self-hosted or on
Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's own, generated by its first-party ApiReference plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Notes
- Timelines
tags_raw:
- Analytics
- Notes
- Timeline
properties:
- type: OpenAPI
url: openapi/matomo-annotations-openapi.json
- type: Overlay
url: overlays/matomo-annotations-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:custom-alerts-api
name: Matomo CustomAlerts API
description: The Matomo CustomAlerts API exposes 7 operations of the Matomo Reporting API (module `CustomAlerts`). Threshold
alerts on any report metric, with triggered-alert history. Every operation is dispatched through the single `/index.php?module=API&method=CustomAlerts.<Action>`
entrypoint on the customer's own Matomo instance, self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's
own, generated by its first-party ApiReference plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Alerts
- Monitoring
properties:
- type: OpenAPI
url: openapi/matomo-custom-alerts-openapi.json
- type: Overlay
url: overlays/matomo-custom-alerts-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:advertising-conversion-export-api
name: Matomo AdvertisingConversionExport API
description: The Matomo AdvertisingConversionExport API exposes 6 operations of the Matomo Reporting API (module `AdvertisingConversionExport`).
Export conversions back out to advertising platforms. Every operation is dispatched through the single `/index.php?module=API&method=AdvertisingConversionExport.<Action>`
entrypoint on the customer's own Matomo instance, self-hosted or on Matomo Cloud. The OpenAPI 3.1.0 document is Matomo's
own, generated by its first-party ApiReference plugin.
humanURL: https://developer.matomo.org/api-reference/reporting-api
baseURL: https://{matomo_host}/index.php
tags:
- Analytics
- Advertising
- Conversions
- Export
properties:
- type: OpenAPI
url: openapi/matomo-advertising-conversion-export-openapi.json
- type: Overlay
url: overlays/matomo-advertising-conversion-export-overlay.yaml
- type: Documentation
url: https://developer.matomo.org/api-reference/reporting-api
- aid: matomo:custom-dimensions-api
name: Matomo CustomDimensio
# --- truncated at 32 KB (63 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/matomo/refs/heads/main/apis.yml
Every provider here is available over the APIs.io API and to AI agents over MCP.