← Tools Reference

Umami

Umami integration (Data, Marketing). Imported from open-connector.

API key8 toolshttps://api.umami.is
GET
umami_get_current_user
Get the current Umami user for the configured API token.

/api/me

GET
umami_list_websites
List Umami websites available to the configured API token.

/api/websites

3 parameters
ParamTypeRequiredDescription
querystringoptionalSearch query filter for the endpoint.
pageintegeroptionalOne-based page number for paginated Umami endpoints.
pageSizeintegeroptionalNumber of items to return per page.
GET
umami_get_website
Get metadata for a single Umami website.

/api/websites/{websiteId}

1 parameter
ParamTypeRequiredDescription
websiteIdstringrequiredThe Umami website ID.
GET
umami_get_website_stats
Get aggregate pageview, visitor, visit, bounce, and time statistics for a website.

/api/websites/{websiteId}/stats

14 parameters
ParamTypeRequiredDescription
websiteIdstringrequiredThe Umami website ID.
startAtintegerrequiredStart timestamp in milliseconds since the Unix epoch.
endAtintegerrequiredEnd timestamp in milliseconds since the Unix epoch.
timezonestringrequiredIANA timezone name used by Umami for date grouping.
urlstringoptionalURL path filter for the query.
referrerstringoptionalReferrer filter for the query.
titlestringoptionalPage title filter for the query.
hoststringoptionalHost filter for the query.
osstringoptionalOperating system filter for the query.
browserstringoptionalBrowser filter for the query.
devicestringoptionalDevice filter for the query.
countrystringoptionalCountry filter for the query.
regionstringoptionalRegion filter for the query.
citystringoptionalCity filter for the query.
GET
umami_get_pageviews
Get Umami pageview and session timeseries for a website.

/api/websites/{websiteId}/pageviews

15 parameters
ParamTypeRequiredDescription
websiteIdstringrequiredThe Umami website ID.
startAtintegerrequiredStart timestamp in milliseconds since the Unix epoch.
endAtintegerrequiredEnd timestamp in milliseconds since the Unix epoch.
timezonestringrequiredIANA timezone name used by Umami for date grouping.
urlstringoptionalURL path filter for the query.
referrerstringoptionalReferrer filter for the query.
titlestringoptionalPage title filter for the query.
hoststringoptionalHost filter for the query.
osstringoptionalOperating system filter for the query.
browserstringoptionalBrowser filter for the query.
devicestringoptionalDevice filter for the query.
countrystringoptionalCountry filter for the query.
regionstringoptionalRegion filter for the query.
citystringoptionalCity filter for the query.
unitstringoptionalTime unit used for timeseries grouping.
GET
umami_get_metrics
Get grouped Umami website metrics such as URLs, referrers, browsers, or countries.

/api/websites/{websiteId}/metrics

16 parameters
ParamTypeRequiredDescription
websiteIdstringrequiredThe Umami website ID.
startAtintegerrequiredStart timestamp in milliseconds since the Unix epoch.
endAtintegerrequiredEnd timestamp in milliseconds since the Unix epoch.
timezonestringrequiredIANA timezone name used by Umami for date grouping.
urlstringoptionalURL path filter for the query.
referrerstringoptionalReferrer filter for the query.
titlestringoptionalPage title filter for the query.
hoststringoptionalHost filter for the query.
osstringoptionalOperating system filter for the query.
browserstringoptionalBrowser filter for the query.
devicestringoptionalDevice filter for the query.
countrystringoptionalCountry filter for the query.
regionstringoptionalRegion filter for the query.
citystringoptionalCity filter for the query.
typestringrequiredWebsite metric dimension to return.
limitintegeroptionalMaximum number of metric rows to return.
GET
umami_get_realtime
Get realtime active visitor data for an Umami website.

/api/realtime/{websiteId}

1 parameter
ParamTypeRequiredDescription
websiteIdstringrequiredThe Umami website ID.
GET
umami_list_events
List tracked Umami events for a website within a time range.

/api/websites/{websiteId}/events

17 parameters
ParamTypeRequiredDescription
websiteIdstringrequiredThe Umami website ID.
startAtintegerrequiredStart timestamp in milliseconds since the Unix epoch.
endAtintegerrequiredEnd timestamp in milliseconds since the Unix epoch.
timezonestringrequiredIANA timezone name used by Umami for date grouping.
urlstringoptionalURL path filter for the query.
referrerstringoptionalReferrer filter for the query.
titlestringoptionalPage title filter for the query.
hoststringoptionalHost filter for the query.
osstringoptionalOperating system filter for the query.
browserstringoptionalBrowser filter for the query.
devicestringoptionalDevice filter for the query.
countrystringoptionalCountry filter for the query.
regionstringoptionalRegion filter for the query.
citystringoptionalCity filter for the query.
querystringoptionalSearch query filter for the endpoint.
pageintegeroptionalOne-based page number for paginated Umami endpoints.
pageSizeintegeroptionalNumber of items to return per page.