Matomo

Matomo Referrers API

The Referrers API lets you access reports about websites, search engines, keywords, social networks, AI assistants, and campaigns used to access your website. For example, "getKeywords" returns all search engine keywords (with general analytics metrics for each keyword), "getWebsites" returns referrer websites (along with the full Referrer URL if the parameter &expanded=1 is set). "getReferrerType" returns the Referrer overview report. "getCampaigns" returns the list of all campaigns (and all campaign keywords if the parameter &expanded=1 is set). "getSocials" returns social network referrers, and "getAIAssistants" returns AI assistant referrers.

GitHub OpenAPI
Business capability
Digital Marketing Management BC-400.60

Operations 23

GET /index.php?module=API&method=Referrers.get Referrers get #
GET /index.php?module=API&method=Referrers.getReferrerType Referrers get referrer type #
GET /index.php?module=API&method=Referrers.getAll Referrers get all #
GET /index.php?module=API&method=Referrers.getKeywords Referrers get keywords #
GET /index.php?module=API&method=Referrers.getSearchEnginesFromKeywordId Referrers get search engines from keyword id #
GET /index.php?module=API&method=Referrers.getSearchEngines Referrers get search engines #
GET /index.php?module=API&method=Referrers.getKeywordsFromSearchEngineId Referrers get keywords from search engine id #
GET /index.php?module=API&method=Referrers.getCampaigns Referrers get campaigns #
GET /index.php?module=API&method=Referrers.getKeywordsFromCampaignId Referrers get keywords from campaign id #
GET /index.php?module=API&method=Referrers.getWebsites Referrers get websites #
GET /index.php?module=API&method=Referrers.getUrlsFromWebsiteId Referrers get urls from website id #
GET /index.php?module=API&method=Referrers.getSocials Referrers get socials #
GET /index.php?module=API&method=Referrers.getAIAssistants Referrers get AI assistants #
GET /index.php?module=API&method=Referrers.getUrlsForSocial Referrers get urls for social #
GET /index.php?module=API&method=Referrers.getEntryPageUrlsForAIAssistant Referrers get entry page urls for AI assistant #
GET /index.php?module=API&method=Referrers.getEntryPageTitlesForAIAssistant Referrers get entry page titles for AI assistant #
GET /index.php?module=API&method=Referrers.getNumberOfDistinctSearchEngines Referrers get number of distinct search engines #
GET /index.php?module=API&method=Referrers.getNumberOfDistinctSocialNetworks Referrers get number of distinct social networks #
GET /index.php?module=API&method=Referrers.getNumberOfDistinctKeywords Referrers get number of distinct keywords #
GET /index.php?module=API&method=Referrers.getNumberOfDistinctCampaigns Referrers get number of distinct campaigns #
GET /index.php?module=API&method=Referrers.getNumberOfDistinctWebsites Referrers get number of distinct websites #
GET /index.php?module=API&method=Referrers.getNumberOfDistinctAIAssistants Referrers get number of distinct AI assistants #
GET /index.php?module=API&method=Referrers.getNumberOfDistinctWebsitesUrls Referrers get number of distinct websites urls #

Documentation

📖
Documentation
https://developer.matomo.org/api-reference/reporting-api
📖
Documentation
https://developer.matomo.org/api-reference/reporting-api#Live
📖
Documentation
https://developer.matomo.org/api-reference/reporting-api#Goals
📖
Documentation
https://developer.matomo.org/api-reference/reporting-api-segmentation

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/matomo/refs/heads/main/openapi/matomo-referrers-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/matomo-referrers-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

matomo-referrers-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Matomo Reporting API for plugin Referrers API
  version: 1.0.0
  description: The Referrers API lets you access reports about websites, search engines, keywords, social networks, AI assistants, and campaigns used to access your website.
servers:
- url: https://demo-proxy.innocraft.cloud/
  description: Current Matomo instance
security:
- MatomoToken: []
tags:


# --- truncated at 32 KB (64 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/matomo/refs/heads/main/openapi/matomo-referrers-api-openapi.yml