简介
matomo官方网址https://developer.matomo.org/api-reference/reporting-api
Matomo 的前身是 Piwik,是一套基于 PHP5+MySQL 技术构建的开源网站访问统计系统。Matomo 可以给你详细的统计信息,比如网页浏览人数,用户访问来源,用户行为,搜索引擎关键词等等流量分析功能,偏运营型辅助统计。此外,它还采用了插件扩展及开放 API 架构,可以让用户根据自已的实际需求创建更多的功能。
一、API接口语法
http://HOST地址/index.php?module=API&method=VisitsSummary.get&idSite=3&period=day&date=today&format=JSON&token_auth=eb25824673af1316890ef958fbjgjda0d44
- module 固定值大写API,以api的方式进行访问
- method 统计数据关键字(包含两个字段module&action,参考官方地址https://demo.matomo.org/?module=API&method=API.getReportMetadata&format=xml&idSite=3&token_auth=anonymous)
已用过的method举例:VisitsSummary.get、VisitsSummary.getUsers、DevicesDetection.getBrand、VisitTime.getVisitInformationPerLocalTime 、UserCountry.getCountry
- idSite 搭建平台时配置的siteId值
- period&date 统计数据的日期
period | date |
---|---|
range | 日期区间(年,月,日),如YYYY-MM-DD,YYYY-MM-DD |
day;week;month;year | 指定日期YYYY-MM-DD;today/yesterday/laskWeek/lastMonth或lastYear/last10(包含本身的10天/周/月/年)/previous10(不包含本身的10天/周/月/年) |
- format 展示数据的样式,有json、csv、html等
- token 搭建平台时配置的token
- 其它:
filter_limit 定义要返回条数(其它行数据不关心),设置为-1以返回所有行
filter_truncate 定义返回行数+1(其它行数据值进行累加,表头以‘其它’做标识并单独组建一行,如下图),置-1返回所有行
例:
https://xxx.xxx.cn/xxx/xxx/index.php?module=API&method=DevicesDetection.getBrand&idSite=16&period=range&date=2021-01-03,2021-01-11&format=html&token_auth="token值"