Matomo

Read your Matomo web analytics: visits, pageviews and conversions for any day, week, month or date range, your top pages, traffic sources, countries, devices, goals and events, and who is on your website right now. Works with Matomo Cloud and with Matomo on your own server.

Actions

Action	What it does
Get browsers	List the browsers visitors used most, such as Chrome, Safari and Firefox.
Get campaigns	List the marketing campaigns that brought the most visits, from the campaign tags on your links.
Get channel types	Break a website's visits down by where they came from: search engines, social networks, other websites, campaigns, AI assistants, or typed in directly.
Get clicked outbound links	List the links to other websites that visitors clicked most, with how many times each was clicked.
Get countries	List the countries the most visits to a website came from.
Get device types	Break a website's visits down by kind of device: desktop, smartphone, tablet and more.
Get downloads	List the files visitors downloaded most from a website, such as PDFs and images, with how many times each was downloaded.
Get events	List the events tracked on a website most often, such as video plays or button clicks, by category, action or name, with their values.
Get goal conversions	Get how often each of a website's goals was reached and the revenue it brought, with online orders and the totals.
Get operating systems	List the operating systems visitors used most, such as Windows, iOS and Android.
Get real-time visitor counts	Count the visits, visitors and actions on a website in the last few minutes, as Matomo's real-time widget shows them.
Get referring websites	List the other websites that sent the most visitors by linking to yours.
Get search engines	List the search engines that sent the most visitors, such as Google and Bing.
Get site search keywords	See what visitors typed into the website's own search box and how often, or only the searches that found nothing.
Get social networks	List the social networks that sent the most visitors, such as Facebook, LinkedIn or Reddit.
Get top pages	Find a website's most viewed pages, or the pages where most visits start (landing pages) or end (exit pages), with views, time on page, bounce rate and exit rate.
Get visits by hour	Count a website's visits in each hour of the day, to see when people visit.
Get visits overview	Get a website's headline numbers for a day, week, month, year or date range: visits, unique visitors, pageviews, time on site, bounce rate, conversions and revenue.
List recent visits	Get the latest visits to a website, newest first: where each visitor came from, their country, device and browser, and every page they viewed.
List websites	List the websites your Matomo tracks that the connected user can see, with each one's address, time zone and currency.

Get browsers

List the browsers visitors used most, such as Chrome, Safari and Firefox.

Inputs

WebsitewebsitetextRequired: The website to report on.
Periodperiodtext: How long a stretch of time to report on.One of: day, week (Week (Monday to Sunday)), month, year, range (Date range). Default: day.
Datedatedate: Any day in the period: the report covers the whole day, week, month or year it falls in. Leave empty for the last full one, such as yesterday or last month, which suits a scheduled report.Only when Period is Day, Week (Monday to Sunday), Month or Year.
Start datestart_datedate: The first day of the range.Only when Period is Date range.
End dateend_datedate: The last day of the range, which is included.Only when Period is Date range.
How manylimitnumber: How many to return, the biggest first.From 1 to 100. Default: 10.

Outputs

browserslist: The browsers, most visits first.
countnumber: How many rows came back.
period_endtext: The last day the report covers, e.g. 2026-09-30.
period_starttext: The first day the report covers, e.g. 2026-09-01.

Example output

{
  "browsers": [
    {
      "actions": 492630,
      "actions_per_visit": 2.3,
      "average_visit_seconds": 185,
      "bounce_rate_percent": 70.59,
      "conversion_rate_percent": 6.92,
      "conversions": 15456,
      "converted_visits": 14956,
      "name": "Chrome",
      "revenue": 1466390.8,
      "visits": 216179
    }
  ],
  "count": 1,
  "period_end": "2026-09-30",
  "period_start": "2026-09-01"
}

Get campaigns

List the marketing campaigns that brought the most visits, from the campaign tags on your links.

Inputs

WebsitewebsitetextRequired: The website to report on.
Periodperiodtext: How long a stretch of time to report on.One of: day, week (Week (Monday to Sunday)), month, year, range (Date range). Default: day.
Datedatedate: Any day in the period: the report covers the whole day, week, month or year it falls in. Leave empty for the last full one, such as yesterday or last month, which suits a scheduled report.Only when Period is Day, Week (Monday to Sunday), Month or Year.
Start datestart_datedate: The first day of the range.Only when Period is Date range.
End dateend_datedate: The last day of the range, which is included.Only when Period is Date range.
How manylimitnumber: How many to return, the biggest first.From 1 to 100. Default: 10.

Outputs

campaignslist: The campaigns, most visits first.
countnumber: How many rows came back.
period_endtext: The last day the report covers, e.g. 2026-09-30.
period_starttext: The first day the report covers, e.g. 2026-09-01.

Example output

{
  "campaigns": [
    {
      "actions": 0,
      "actions_per_visit": 0.0,
      "average_visit_seconds": 0,
      "bounce_rate_percent": 0.0,
      "conversion_rate_percent": 0.0,
      "conversions": 16,
      "converted_visits": 0,
      "name": "org_newsletter_2018_06_12",
      "revenue": 0.0,
      "visits": 0
    }
  ],
  "count": 1,
  "period_end": "2026-09-30",
  "period_start": "2026-09-01"
}

Get channel types

Break a website's visits down by where they came from: search engines, social networks, other websites, campaigns, AI assistants, or typed in directly.

Inputs

WebsitewebsitetextRequired: The website to report on.
Periodperiodtext: How long a stretch of time to report on.One of: day, week (Week (Monday to Sunday)), month, year, range (Date range). Default: day.
Datedatedate: Any day in the period: the report covers the whole day, week, month or year it falls in. Leave empty for the last full one, such as yesterday or last month, which suits a scheduled report.Only when Period is Day, Week (Monday to Sunday), Month or Year.
Start datestart_datedate: The first day of the range.Only when Period is Date range.
End dateend_datedate: The last day of the range, which is included.Only when Period is Date range.

Outputs

channelslist: Each kind of source, most visits first.
countnumber: How many rows came back.
period_endtext: The last day the report covers, e.g. 2026-09-30.
period_starttext: The first day the report covers, e.g. 2026-09-01.

Example output

{
  "channels": [
    {
      "actions": 416789,
      "actions_per_visit": 1.8,
      "average_visit_seconds": 106,
      "bounce_rate_percent": 73.42,
      "conversion_rate_percent": 6.29,
      "conversions": 19133,
      "converted_visits": 14935,
      "name": "Search Engines",
      "revenue": 405835.05,
      "visits": 237304
    }
  ],
  "count": 1,
  "period_end": "2026-09-30",
  "period_start": "2026-09-01"
}

Get clicked outbound links

List the links to other websites that visitors clicked most, with how many times each was clicked.

Inputs

WebsitewebsitetextRequired: The website to report on.
Periodperiodtext: How long a stretch of time to report on.One of: day, week (Week (Monday to Sunday)), month, year, range (Date range). Default: day.
Datedatedate: Any day in the period: the report covers the whole day, week, month or year it falls in. Leave empty for the last full one, such as yesterday or last month, which suits a scheduled report.Only when Period is Day, Week (Monday to Sunday), Month or Year.
Start datestart_datedate: The first day of the range.Only when Period is Date range.
End dateend_datedate: The last day of the range, which is included.Only when Period is Date range.
How manylimitnumber: How many to return, the biggest first.From 1 to 100. Default: 10.

Outputs

countnumber: How many rows came back.
linkslist: The links, most clicked first.
period_endtext: The last day the report covers, e.g. 2026-09-30.
period_starttext: The first day the report covers, e.g. 2026-09-01.

Example output

{
  "count": 1,
  "links": [
    {
      "clicks": 2735,
      "domain": "www.facebook.com",
      "unique_clicks": 2671,
      "url": "https://www.facebook.com/Divezone.net"
    }
  ],
  "period_end": "2026-09-30",
  "period_start": "2026-09-01"
}

Get countries

List the countries the most visits to a website came from.

Inputs

WebsitewebsitetextRequired: The website to report on.
Periodperiodtext: How long a stretch of time to report on.One of: day, week (Week (Monday to Sunday)), month, year, range (Date range). Default: day.
Datedatedate: Any day in the period: the report covers the whole day, week, month or year it falls in. Leave empty for the last full one, such as yesterday or last month, which suits a scheduled report.Only when Period is Day, Week (Monday to Sunday), Month or Year.
Start datestart_datedate: The first day of the range.Only when Period is Date range.
End dateend_datedate: The last day of the range, which is included.Only when Period is Date range.
How manylimitnumber: How many to return, the biggest first.From 1 to 100. Default: 10.

Outputs

countnumber: How many rows came back.
countrieslist: The countries, most visits first.
period_endtext: The last day the report covers, e.g. 2026-09-30.
period_starttext: The first day the report covers, e.g. 2026-09-01.

Example output

{
  "count": 1,
  "countries": [
    {
      "actions": 169041,
      "actions_per_visit": 2.2,
      "average_visit_seconds": 159,
      "bounce_rate_percent": 68.98,
      "conversion_rate_percent": 8.08,
      "conversions": 6425,
      "converted_visits": 6271,
      "country_code": "US",
      "name": "United States",
      "revenue": 523301.6,
      "visits": 77575
    }
  ],
  "period_end": "2026-09-30",
  "period_start": "2026-09-01"
}

Get device types

Break a website's visits down by kind of device: desktop, smartphone, tablet and more.

Inputs

WebsitewebsitetextRequired: The website to report on.
Periodperiodtext: How long a stretch of time to report on.One of: day, week (Week (Monday to Sunday)), month, year, range (Date range). Default: day.
Datedatedate: Any day in the period: the report covers the whole day, week, month or year it falls in. Leave empty for the last full one, such as yesterday or last month, which suits a scheduled report.Only when Period is Day, Week (Monday to Sunday), Month or Year.
Start datestart_datedate: The first day of the range.Only when Period is Date range.
End dateend_datedate: The last day of the range, which is included.Only when Period is Date range.

Outputs

countnumber: How many rows came back.
device_typeslist: Each kind of device, most visits first.
period_endtext: The last day the report covers, e.g. 2026-09-30.
period_starttext: The first day the report covers, e.g. 2026-09-01.

Example output

{
  "count": 1,
  "device_types": [
    {
      "actions": 718710,
      "actions_per_visit": 2.9,
      "average_visit_seconds": 264,
      "bounce_rate_percent": 58.38,
      "conversion_rate_percent": 9.13,
      "conversions": 23455,
      "converted_visits": 22662,
      "name": "Desktop",
      "revenue": 2458258.2,
      "visits": 248180
    }
  ],
  "period_end": "2026-09-30",
  "period_start": "2026-09-01"
}

Get downloads

List the files visitors downloaded most from a website, such as PDFs and images, with how many times each was downloaded.

Inputs

WebsitewebsitetextRequired: The website to report on.
Periodperiodtext: How long a stretch of time to report on.One of: day, week (Week (Monday to Sunday)), month, year, range (Date range). Default: day.
Datedatedate: Any day in the period: the report covers the whole day, week, month or year it falls in. Leave empty for the last full one, such as yesterday or last month, which suits a scheduled report.Only when Period is Day, Week (Monday to Sunday), Month or Year.
Start datestart_datedate: The first day of the range.Only when Period is Date range.
End dateend_datedate: The last day of the range, which is included.Only when Period is Date range.
How manylimitnumber: How many to return, the biggest first.From 1 to 100. Default: 10.

Outputs

countnumber: How many rows came back.
downloadslist: The files, most downloaded first.
period_endtext: The last day the report covers, e.g. 2026-09-30.
period_starttext: The first day the report covers, e.g. 2026-09-01.

Example output

{
  "count": 1,
  "downloads": [
    {
      "downloads": 72,
      "file_name": "komodo-island-map.jpg",
      "unique_downloads": 68,
      "url": "https://divezone.net/wp-content/uploads/2012/05/komodo-island-map.jpg"
    }
  ],
  "period_end": "2026-09-30",
  "period_start": "2026-09-01"
}

Get events

List the events tracked on a website most often, such as video plays or button clicks, by category, action or name, with their values.

Inputs

WebsitewebsitetextRequired: The website to report on.
Periodperiodtext: How long a stretch of time to report on.One of: day, week (Week (Monday to Sunday)), month, year, range (Date range). Default: day.
Datedatedate: Any day in the period: the report covers the whole day, week, month or year it falls in. Leave empty for the last full one, such as yesterday or last month, which suits a scheduled report.Only when Period is Day, Week (Monday to Sunday), Month or Year.
Start datestart_datedate: The first day of the range.Only when Period is Date range.
End dateend_datedate: The last day of the range, which is included.Only when Period is Date range.
Group events bygroup_bytext: Matomo files every event under a category, an action and a name, such as Videos, play and Intro.One of: category (Event category), action (Event action), name (Event name). Default: category.
How manylimitnumber: How many to return, the biggest first.From 1 to 100. Default: 10.

Outputs

countnumber: How many rows came back.
eventslist: The events, most frequent first.
period_endtext: The last day the report covers, e.g. 2026-09-30.
period_starttext: The first day the report covers, e.g. 2026-09-01.

Example output

{
  "count": 1,
  "events": [
    {
      "average_value": 107.82,
      "events": 17430,
      "events_with_value": 15147,
      "name": "MediaVideo",
      "total_value": 1633182.0,
      "visits": 11116
    }
  ],
  "period_end": "2026-09-30",
  "period_start": "2026-09-01"
}

Get goal conversions

Get how often each of a website's goals was reached and the revenue it brought, with online orders and the totals.

Inputs

WebsitewebsitetextRequired: The website to report on.
Periodperiodtext: How long a stretch of time to report on.One of: day, week (Week (Monday to Sunday)), month, year, range (Date range). Default: day.
Datedatedate: Any day in the period: the report covers the whole day, week, month or year it falls in. Leave empty for the last full one, such as yesterday or last month, which suits a scheduled report.Only when Period is Day, Week (Monday to Sunday), Month or Year.
Start datestart_datedate: The first day of the range.Only when Period is Date range.
End dateend_datedate: The last day of the range, which is included.Only when Period is Date range.

Outputs

conversion_rate_percentnumber: Share of visits that reached a goal, in percent, e.g. 7.4.
conversionsnumber: Goals reached and orders placed, all told.
converted_visitsnumber: Visits that reached at least one goal or placed an order.
countnumber: How many rows came back.
goalslist: Each goal, and the online orders on a shop, most conversions first.
period_endtext: The last day the report covers, e.g. 2026-09-30.
period_starttext: The first day the report covers, e.g. 2026-09-01.
revenuenumber: Revenue from every goal and order, in the website's currency.

Example output

{
  "conversion_rate_percent": 7.4,
  "conversions": 32782,
  "converted_visits": 31767,
  "count": 2,
  "goals": [
    {
      "conversion_rate_percent": 2.68,
      "conversions": 11791,
      "converted_visits": 11516,
      "name": "Ecommerce orders",
      "revenue": 2455997.55
    },
    {
      "conversion_rate_percent": 0.1,
      "conversions": 437,
      "converted_visits": 437,
      "name": "Newsletter Signup",
      "revenue": 0.0
    }
  ],
  "period_end": "2026-09-30",
  "period_start": "2026-09-01",
  "revenue": 2475114.55
}

Get operating systems

List the operating systems visitors used most, such as Windows, iOS and Android.

Inputs

WebsitewebsitetextRequired: The website to report on.
Periodperiodtext: How long a stretch of time to report on.One of: day, week (Week (Monday to Sunday)), month, year, range (Date range). Default: day.
Datedatedate: Any day in the period: the report covers the whole day, week, month or year it falls in. Leave empty for the last full one, such as yesterday or last month, which suits a scheduled report.Only when Period is Day, Week (Monday to Sunday), Month or Year.
Start datestart_datedate: The first day of the range.Only when Period is Date range.
End dateend_datedate: The last day of the range, which is included.Only when Period is Date range.
How manylimitnumber: How many to return, the biggest first.From 1 to 100. Default: 10.

Outputs

countnumber: How many rows came back.
operating_systemslist: The operating systems, most visits first.
period_endtext: The last day the report covers, e.g. 2026-09-30.
period_starttext: The first day the report covers, e.g. 2026-09-01.

Example output

{
  "count": 1,
  "operating_systems": [
    {
      "actions": 415266,
      "actions_per_visit": 3.2,
      "average_visit_seconds": 311,
      "bounce_rate_percent": 51.03,
      "conversion_rate_percent": 10.08,
      "conversions": null,
      "converted_visits": 13069,
      "name": "Windows",
      "revenue": null,
      "visits": 129703
    }
  ],
  "period_end": "2026-09-30",
  "period_start": "2026-09-01"
}

Get real-time visitor counts

Count the visits, visitors and actions on a website in the last few minutes, as Matomo's real-time widget shows them.

Inputs

WebsitewebsitetextRequired: The website to report on.
Last minutesminutesnumber: How many minutes back to count, up to 48 hours.From 1 to 2880. Default: 30.

Outputs

actionsnumber: Pages viewed, files downloaded, links clicked and searches made during those visits.
converted_visitsnumber: Visits that reached at least one goal or placed an order.
minutesnumber: How many minutes back the counts go.
visitorsnumber: Different visitors in those minutes.
visitsnumber: Visits active in those minutes.

Example output

{
  "actions": 460,
  "converted_visits": 40,
  "minutes": 30,
  "visitors": 213,
  "visits": 235
}

Get referring websites

List the other websites that sent the most visitors by linking to yours.

Inputs

WebsitewebsitetextRequired: The website to report on.
Periodperiodtext: How long a stretch of time to report on.One of: day, week (Week (Monday to Sunday)), month, year, range (Date range). Default: day.
Datedatedate: Any day in the period: the report covers the whole day, week, month or year it falls in. Leave empty for the last full one, such as yesterday or last month, which suits a scheduled report.Only when Period is Day, Week (Monday to Sunday), Month or Year.
Start datestart_datedate: The first day of the range.Only when Period is Date range.
End dateend_datedate: The last day of the range, which is included.Only when Period is Date range.
How manylimitnumber: How many to return, the biggest first.From 1 to 100. Default: 10.

Outputs

countnumber: How many rows came back.
period_endtext: The last day the report covers, e.g. 2026-09-30.
period_starttext: The first day the report covers, e.g. 2026-09-01.
websiteslist: The websites, most visits first.

Example output

{
  "count": 1,
  "period_end": "2026-09-30",
  "period_start": "2026-09-01",
  "websites": [
    {
      "actions": 56203,
      "actions_per_visit": 3.9,
      "average_visit_seconds": 402,
      "bounce_rate_percent": 46.69,
      "conversion_rate_percent": 10.91,
      "conversions": 1419,
      "converted_visits": 1562,
      "name": "diveadvisor.com",
      "revenue": 235493.7,
      "url": "https://diveadvisor.com",
      "visits": 14317
    }
  ]
}

Get search engines

List the search engines that sent the most visitors, such as Google and Bing.

Inputs

WebsitewebsitetextRequired: The website to report on.
Periodperiodtext: How long a stretch of time to report on.One of: day, week (Week (Monday to Sunday)), month, year, range (Date range). Default: day.
Datedatedate: Any day in the period: the report covers the whole day, week, month or year it falls in. Leave empty for the last full one, such as yesterday or last month, which suits a scheduled report.Only when Period is Day, Week (Monday to Sunday), Month or Year.
Start datestart_datedate: The first day of the range.Only when Period is Date range.
End dateend_datedate: The last day of the range, which is included.Only when Period is Date range.
How manylimitnumber: How many to return, the biggest first.From 1 to 100. Default: 10.

Outputs

countnumber: How many rows came back.
period_endtext: The last day the report covers, e.g. 2026-09-30.
period_starttext: The first day the report covers, e.g. 2026-09-01.
search_engineslist: The search engines, most visits first.

Example output

{
  "count": 1,
  "period_end": "2026-09-30",
  "period_start": "2026-09-01",
  "search_engines": [
    {
      "actions": 354088,
      "actions_per_visit": 1.6,
      "average_visit_seconds": 91,
      "bounce_rate_percent": 74.93,
      "conversion_rate_percent": 6.0,
      "conversions": 17082,
      "converted_visits": 12921,
      "name": "Google",
      "revenue": 182676.3,
      "url": "http://google.com",
      "visits": 215367
    }
  ]
}

Get site search keywords

See what visitors typed into the website's own search box and how often, or only the searches that found nothing.

Inputs

WebsitewebsitetextRequired: The website to report on.
Periodperiodtext: How long a stretch of time to report on.One of: day, week (Week (Monday to Sunday)), month, year, range (Date range). Default: day.
Datedatedate: Any day in the period: the report covers the whole day, week, month or year it falls in. Leave empty for the last full one, such as yesterday or last month, which suits a scheduled report.Only when Period is Day, Week (Monday to Sunday), Month or Year.
Start datestart_datedate: The first day of the range.Only when Period is Date range.
End dateend_datedate: The last day of the range, which is included.Only when Period is Date range.
Only searches with no resultsonly_no_resultstrue/false: Show only what people searched for and didn't find: content your website may be missing.Default: false.
How manylimitnumber: How many to return, the biggest first.From 1 to 100. Default: 10.

Outputs

countnumber: How many rows came back.
keywordslist: The searches, most frequent first.
period_endtext: The last day the report covers, e.g. 2026-09-30.
period_starttext: The first day the report covers, e.g. 2026-09-01.

Example output

{
  "count": 1,
  "keywords": [
    {
      "exit_rate_percent": 23.49,
      "keyword": "starter",
      "result_pages_per_search": 1.2,
      "searches": 1494
    }
  ],
  "period_end": "2026-09-30",
  "period_start": "2026-09-01"
}

List the social networks that sent the most visitors, such as Facebook, LinkedIn or Reddit.

Inputs

WebsitewebsitetextRequired: The website to report on.
Periodperiodtext: How long a stretch of time to report on.One of: day, week (Week (Monday to Sunday)), month, year, range (Date range). Default: day.
Datedatedate: Any day in the period: the report covers the whole day, week, month or year it falls in. Leave empty for the last full one, such as yesterday or last month, which suits a scheduled report.Only when Period is Day, Week (Monday to Sunday), Month or Year.
Start datestart_datedate: The first day of the range.Only when Period is Date range.
End dateend_datedate: The last day of the range, which is included.Only when Period is Date range.
How manylimitnumber: How many to return, the biggest first.From 1 to 100. Default: 10.

Outputs

countnumber: How many rows came back.
period_endtext: The last day the report covers, e.g. 2026-09-30.
period_starttext: The first day the report covers, e.g. 2026-09-01.
social_networkslist: The social networks, most visits first.

Example output

{
  "count": 1,
  "period_end": "2026-09-30",
  "period_start": "2026-09-01",
  "social_networks": [
    {
      "actions": 89442,
      "actions_per_visit": 3.4,
      "average_visit_seconds": 311,
      "bounce_rate_percent": 54.42,
      "conversion_rate_percent": 9.58,
      "conversions": 2159,
      "converted_visits": 2557,
      "name": "reddit",
      "revenue": 380643.1,
      "url": "https://reddit.com",
      "visits": 26679
    }
  ]
}

Get top pages

Find a website's most viewed pages, or the pages where most visits start (landing pages) or end (exit pages), with views, time on page, bounce rate and exit rate.

Inputs

WebsitewebsitetextRequired: The website to report on.
Periodperiodtext: How long a stretch of time to report on.One of: day, week (Week (Monday to Sunday)), month, year, range (Date range). Default: day.
Datedatedate: Any day in the period: the report covers the whole day, week, month or year it falls in. Leave empty for the last full one, such as yesterday or last month, which suits a scheduled report.Only when Period is Day, Week (Monday to Sunday), Month or Year.
Start datestart_datedate: The first day of the range.Only when Period is Date range.
End dateend_datedate: The last day of the range, which is included.Only when Period is Date range.
Rank byrank_bytext: Which pages come first.One of: views (Most viewed), entrances (Most visits started there (landing pages)), exits (Most visits ended there (exit pages)). Default: views.
Show pages byshow_bytext: Whether to list pages by their address or by their title, which groups pages that share one.One of: address (Page address), title (Page title). Default: address.
How manylimitnumber: How many to return, the biggest first.From 1 to 100. Default: 10.

Outputs

countnumber: How many rows came back.
pageslist: The pages, top first.
period_endtext: The last day the report covers, e.g. 2026-09-30.
period_starttext: The first day the report covers, e.g. 2026-09-01.

Example output

{
  "count": 1,
  "pages": [
    {
      "average_time_on_page_seconds": 57,
      "bounce_rate_percent": 48.79,
      "entrances": 11222,
      "exit_rate_percent": 34.18,
      "exits": 13096,
      "page": "/cart/",
      "pageviews": 50491,
      "unique_pageviews": 38319,
      "url": "https://dive-shop.net/cart/"
    }
  ],
  "period_end": "2026-09-30",
  "period_start": "2026-09-01"
}

Get visits by hour

Count a website's visits in each hour of the day, to see when people visit.

Inputs

WebsitewebsitetextRequired: The website to report on.
Periodperiodtext: How long a stretch of time to report on.One of: day, week (Week (Monday to Sunday)), month, year, range (Date range). Default: day.
Datedatedate: Any day in the period: the report covers the whole day, week, month or year it falls in. Leave empty for the last full one, such as yesterday or last month, which suits a scheduled report.Only when Period is Day, Week (Monday to Sunday), Month or Year.
Start datestart_datedate: The first day of the range.Only when Period is Date range.
End dateend_datedate: The last day of the range, which is included.Only when Period is Date range.
Hours inclocktext: Whose clock the hours are counted on.One of: website (The website's time zone), visitor (Each visitor's own time). Default: website.

Outputs

countnumber: How many rows came back.
hourslist: Each hour with visits, midnight first.
period_endtext: The last day the report covers, e.g. 2026-09-30.
period_starttext: The first day the report covers, e.g. 2026-09-01.

Example output

{
  "count": 1,
  "hours": [
    {
      "actions": 67645,
      "actions_per_visit": 2.6,
      "average_visit_seconds": 230,
      "bounce_rate_percent": 63.38,
      "conversion_rate_percent": 8.43,
      "conversions": 2349,
      "converted_visits": 2221,
      "hour": 14,
      "name": "14:00",
      "revenue": 254147.3,
      "visits": 26337
    }
  ],
  "period_end": "2026-09-30",
  "period_start": "2026-09-01"
}

Get visits overview

Get a website's headline numbers for a day, week, month, year or date range: visits, unique visitors, pageviews, time on site, bounce rate, conversions and revenue.

Inputs

WebsitewebsitetextRequired: The website to report on.
Periodperiodtext: How long a stretch of time to report on.One of: day, week (Week (Monday to Sunday)), month, year, range (Date range). Default: day.
Datedatedate: Any day in the period: the report covers the whole day, week, month or year it falls in. Leave empty for the last full one, such as yesterday or last month, which suits a scheduled report.Only when Period is Day, Week (Monday to Sunday), Month or Year.
Start datestart_datedate: The first day of the range.Only when Period is Date range.
End dateend_datedate: The last day of the range, which is included.Only when Period is Date range.

Outputs

actionsnumber: Pages viewed, files downloaded, links clicked and searches made during those visits.
actions_per_visitnumber: Actions in an average visit, e.g. 2.3.
average_visit_durationtext: The same, written out, e.g. 2 min 59 s.
average_visit_secondsnumber: How long an average visit lasted, in seconds.
bounce_rate_percentnumber: Share of visits that left after one page, in percent, e.g. 46.7.
bouncesnumber: Visits that left after one page.
conversion_rate_percentnumber: Share of visits that reached a goal, in percent, e.g. 7.4.
conversionsnumber: Goals reached and orders placed.
converted_visitsnumber: Visits that reached at least one goal or placed an order.
downloadsnumber: Files downloaded.
new_visitsnumber: Visits by people who hadn't visited before.
outbound_link_clicksnumber: Clicks on links to other websites.
pageviewsnumber: Pages viewed.
period_endtext: The last day the report covers, e.g. 2026-09-30.
period_starttext: The first day the report covers, e.g. 2026-09-01.
returning_visitsnumber: Visits by people who had visited before.
revenuenumber: Revenue from goals and orders, in the website's currency.
site_searchesnumber: Searches made with the website's own search box.
unique_pageviewsnumber: Pages viewed, counting each page once a visit.
unique_visitorsnumber: Different visitors. Null when your Matomo isn't set to count them for this kind of period, which by default is a month, a year or a date range.
visitsnumber: Visits in the period.

Example output

{
  "actions": 32077,
  "actions_per_visit": 2.3,
  "average_visit_duration": "2 min 59 s",
  "average_visit_seconds": 179,
  "bounce_rate_percent": 66.96,
  "bounces": 9311,
  "conversion_rate_percent": 7.18,
  "conversions": 1026,
  "converted_visits": 999,
  "downloads": 35,
  "new_visits": 2491,
  "outbound_link_clicks": 1614,
  "pageviews": 26910,
  "period_end": "2026-10-15",
  "period_start": "2026-10-15",
  "returning_visits": 11414,
  "revenue": 74003.65,
  "site_searches": 210,
  "unique_pageviews": 22429,
  "unique_visitors": 11062,
  "visits": 13905
}

List recent visits

Get the latest visits to a website, newest first: where each visitor came from, their country, device and browser, and every page they viewed.

Inputs

WebsitewebsitetextRequired: The website to report on.
Sincesincedate and time: Only visits active after this moment, such as the last time the workflow ran. Leave empty for the latest visits.
How manylimitnumber: How many to return, the biggest first.From 1 to 100. Default: 10.

Outputs

countnumber: How many rows came back.
visitslist: The visits, newest first.

Example output

{
  "count": 1,
  "visits": [
    {
      "actions": 2,
      "activity": [
        {
          "time_spent_seconds": 82,
          "title": "Budget Liveaboard Komodo \u2013 Divezone",
          "type": "page view",
          "url": "https://divezone.net/budget-komodo-liveaboard"
        },
        {
          "time_spent_seconds": 0,
          "title": "MV Ambai Liveaboard Review \u2013 Komodo Island, Raja Ampat, Indonesia Dive Boat Reviews",
          "type": "page view",
          "url": "https://divezone.net/liveaboard/mv-ambai"
        }
      ],
      "browser": "Mobile Safari 11.0",
      "campaign": null,
      "channel": "Search Engines",
      "city": "West Jakarta",
      "converted": false,
      "country": "Indonesia",
      "country_code": "ID",
      "device": "Apple iPhone",
      "device_type": "Smartphone",
      "duration_seconds": 83,
      "entry_page_url": "https://divezone.net/budget-komodo-liveaboard",
      "exit_page_url": "https://divezone.net/liveaboard/mv-ambai",
      "goal_conversions": 0,
      "language": null,
      "last_action_at": "2026-10-16T02:36:52Z",
      "operating_system": "iOS 11.2",
      "pages_viewed": 2,
      "referrer_name": "Google",
      "referrer_url": "https://www.google.de/",
      "region": "Jakarta Raya",
      "revenue": 0.0,
      "search_keyword": null,
      "started_at": "2026-10-16T02:35:30Z",
      "user_id": null,
      "visit_id": 23591199,
      "visit_number": 253,
      "visitor_type": "returning customer"
    }
  ]
}

List websites

List the websites your Matomo tracks that the connected user can see, with each one's address, time zone and currency.

Inputs

How manylimitnumber: How many websites to return, oldest first.From 1 to 1000. Default: 100.

Outputs

countnumber: How many rows came back.
has_moretrue/false: Whether there are more websites than were returned. Raise How many to get them.
totalnumber: How many websites the user can see in all.
websiteslist: The websites, oldest first, so the first is usually the main one.

Example output

{
  "count": 1,
  "has_more": false,
  "total": 1,
  "websites": [
    {
      "created_at": "2011-06-27T09:42:22Z",
      "currency": "USD",
      "ecommerce": true,
      "id": 1,
      "name": "Demo Site",
      "site_search": true,
      "timezone": "Europe/Paris",
      "url": "https://divezone.net"
    }
  ]
}

ActionsCopy Anchor Link

Get browsersCopy Anchor Link

Inputs

Outputs

Get campaignsCopy Anchor Link

Inputs

Outputs

Get channel typesCopy Anchor Link

Inputs

Outputs

Get clicked outbound linksCopy Anchor Link

Inputs

Outputs

Get countriesCopy Anchor Link

Inputs

Outputs

Get device typesCopy Anchor Link

Inputs

Outputs

Get downloadsCopy Anchor Link

Inputs

Outputs

Get eventsCopy Anchor Link

Inputs

Outputs

Get goal conversionsCopy Anchor Link

Inputs

Outputs

Get operating systemsCopy Anchor Link

Inputs

Outputs

Get real-time visitor countsCopy Anchor Link

Inputs

Outputs

Get referring websitesCopy Anchor Link

Inputs

Outputs

Get search enginesCopy Anchor Link

Inputs

Outputs

Get site search keywordsCopy Anchor Link

Inputs

Outputs

Get social networksCopy Anchor Link

Inputs

Outputs

Get top pagesCopy Anchor Link

Inputs

Outputs

Get visits by hourCopy Anchor Link

Inputs

Outputs

Get visits overviewCopy Anchor Link

Inputs

Outputs

List recent visitsCopy Anchor Link

Inputs

Outputs

List websitesCopy Anchor Link

Inputs

Outputs

On this page

Actions

Get browsers

Get campaigns

Get channel types

Get clicked outbound links

Get countries

Get device types

Get downloads

Get events

Get goal conversions

Get operating systems

Get real-time visitor counts

Get referring websites

Get search engines

Get site search keywords

Get social networks

Get top pages

Get visits by hour

Get visits overview

List recent visits

List websites