教程:获取你的前10个关键词

本教程将向您展示请求昨天的十大关键词XML格式。

构建URL

要构建API调用的URL，你需要:

• 您的Matomo(以前是Piwik)基础URL(用您的Matomo服务器的URL和路径替换demo.m.hju8.com)

  https://demo.m.hju8.com/?module=API

• 要调用的方法的名称。格式是这样的moduleName.methodToCall(详情见API方法)。你需要从插件Referrers请求最后一个关键字:

  方法= Referrers.getKeywords

• 网站id

  idSite = 1

• 日期参数。这可以是今天，昨天，或任何带有格式的日期YYYY-MM-DD

  昨天日期=

• 周期参数。这可以是一天，周，月或一年

  时间=一天

  或者，如果希望请求给定日期的所有关键字，可以使用日期范围参数。例如，请求自2011年1月1日以来的所有关键字:时间= range&date = 2011-01-01,昨天

• format参数。定义数据的输出格式:XML、JSON、CSV、PHP(序列化PHP)、HTML(简单HTML)

  format = xml

• (可选)定义返回行数的filter_limit参数

  filter_limit = 10

最终的url是https://demo.m.hju8.com/?module=API&method=Referrers.getKeywords&idSite=3&date=yesterday&period=day&format=xml&filter_limit=10

XML输出

下面是这个请求的输出:

<？>  <错误信息="你不能访问这个资源，因为它需要'查看'访问网站id = 3。"结果/ > < / >

其他的例子

• XML中最近10天的访问记录，每天一项https://demo.m.hju8.com/?module=API&method=VisitsSummary.getVisits&idSite=3&period=day&date=last10&format=xml

• XML包含过去3周的关键字，每周一个条目https://demo.m.hju8.com/?module=API&method=Referrers.getKeywords&idSite=3&period=week&date=last3&format=xml

• XML，包含过去3天内匹配模式“piwik”的关键字https://demo.m.hju8.com/?module=API&method=Referrers.getKeywords&idSite=3&period=day&date=last3&format=xml&filter_column=label&filter_pattern=piwik

• 包含过去3周前30个关键字的RSS提要，按人们从这些关键字中获得的操作数量排序https://demo.m.hju8.com/?module=API&method=Referrers.getKeywords&idSite=3&period=week&date=last3&format=rss&filter_limit=30&filter_sort_column=3您可以以以下格式之一获取数据:XML、JSON、HTML、CSV、TSV等。看到API参考用于文档。

也有功能的网站，用户，目标，PDF报告(创建，更新，删除操作)和更多，如:添加注释，创建自定义片段，