本指南解释了如何调用Matomo(以前是Piwik) API来请求您的web分析数据。
如果你想用任何语言(PHP, Python, Ruby, ASP, c++， Java等)请求数据，你可以使用HTTP API。这是一种通过HTTP GET请求数据的简单方法。
安全注意
如果API调用需要token_auth，并且HTTP请求是通过不受信任的网络发送的，我们强烈建议您使用加密请求。否则，您的token_auth将暴露给窃听者。这可以通过使用https而不是http来实现。
例如，您可以获得本月大多数访问者来自的国家的列表。下面是一个PHP的例子:
<？这个令牌用来验证你的API请求。//你可以在你的Matomo接口的API页面上获得令牌$token_auth = '匿名';//我们调用REST API，为idsite=62 $url = "https://demo.www.hju8.com/"请求上个月的前100个关键字;$url .= "?module=API&method=UserCountry.getCountry";$url .= "&idSite=62&period=month&date=today";$url .= "&format=JSON&filter_limit=10";$url .= "&token_auth=$token_auth";$fetch = file_get_contents($url);$content = json_decode($fetch,true); // case error if (!$content) { print("No data found"); } print("Countries with most visits
\n"); foreach ($content as $row) { $countryName = htmlspecialchars($row["label"], ENT_QUOTES, 'UTF-8'); $hits = $row['nb_visits']; print("$countryName ($hits visits)
\n"); }下面是这段代码的输出:
访问量最多的国家
美国(50504访问量)
澳大利亚(23099访问量)
英国(22298访问量)
印度尼西亚(15631访问量)
德国(14497访问量)
新加坡(10969访问量)
(9974访问量)
马来西亚(9195访问量)
泰国(8956访问量)
要了解调用报表API时可用的所有选项的更多信息，请阅读报告API参考．
你也可以看看客户端库列表可以调用报告API。