Analytics API User Guide - APIs

This page is a hub space linking to the Analytics API guides.

There are two main APIs in Matomo

Analytics Web API: used to request all Matomo reports and to manage (add, update, delete) websites, users, permissions, email reports, etc.
Tracking Web API: used to record data in Matomo using the JavaScript Code or using the other languages

You can use the Analytics API to programmatically request reports (number of visits, page URLs, page titles, user settings, search engines, keywords, referrer websites, user browsers, etc.) for a list of websites, and a given date and period (day, week, month, year). The data can be requested in any format: xml, csv, json, Excel, etc. When you're using Matomo you can export the data of any report by clicking the "Export" icon below each report.

Matomo also provides APIs to create, edit and delete websites, users, user privileges, goals and PDF reports. Many users are using the API to automatically provide Matomo to their customers' websites.

Getting started

What is the token_auth and where can I find this token to use in the API calls?Find the website ID, also called idSite or Site ID

Security

How do I configure my Matomo server to allow cross domain requests? (CORS)

How to

Is there a way to get all visitor profiles for a particular website or idSite?How do I get the Visitor Geo Location data from the Visitor IP? (or in JavaScript/JSON when IP address is not known)

Troubleshoot

Why is the ‘url’ missing from some of the rows in data exports for Actions API?

Learn more in the Matomo API documentation pages:

Getting started: Fetch The Top 10 Keywords
Matomo (Piwik) API Reference Lists of all Matomo API functions, list of standard and optional parameters, and more
Matomo Metadata API. Use the Metadata API to retrieve enriched data (translated labels, column names, report category, etc.)
Matomo Segmentation in the API Learn how to request Matomo reports filtered to a segment of visits.
How to call the Matomo API? Learn about the two methods of calling the API: using the REST API over HTTP, or loading the Matomo PHP files directly in your app.
Include Static PNG Graphs It is easy to include dynamic PNG Graphs plotting any metric or report. The Static PNG Graphs API can be used on any HTML page, or desktop/Mobile App. It is used to draw graphs in Matomo Mobile
Real time Analytics API via the Live! API The Live! API is the API provided by the Live! plugin, which lets you access 1) real time counters, 2) individual visit sessions and pages, as well as their converted goals, custom variables and all other the data about your visits.
In the API page in your Matomo server (accessible via the top menu Administration link, then click « API » in left menu). The API page lists all API functions with example URLs as well as your token_auth. See the API page on the Matomo demo.

This page was about the Analytics Reporting & Management APIs. You may be find the Tracking API Guide useful.