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

There are two main APIs in Piwik

  • Analytics Web API: used to request all Piwik reports and to manage (add, update, delete) websites, users, permissions, email reports, etc.
  • Tracking Web API: used to record data in Piwik 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, serialized php, etc.

Piwik 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 Piwik to their customers’ websites.

Learn more in the Piwik API documentation pages:

  • Getting started: Fetch The Top 10 Keywords
  • Piwik API Reference Lists of all Piwik API functions, list of standard and optional parameters, and more
  • Piwik Metadata API. Use the Metadata API to retrieve enriched data (translated labels, column names, report category, etc.)
  • Piwik Segmentation in the API Learn how to request Piwik reports filtered to a segment of visits.
  • How to call the Piwik API? Learn about the two methods of calling the API: using the REST API over HTTP, or loading the Piwik 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 Piwik 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 Piwik server (accessible via the top menu username 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 Piwik demo.

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