Umami API

API Paid Caution Analytics Has MCP ↗
Pricing

$20/mo

Cloud API needs Pro at $20/mo. Hobby is free but has no API.

Free tier

Self-host only (free, open source)

Auth

API key

Cloud API key sent as Authorization Bearer. Self-hosted instances use their own authentication flow.

Data it gives

Pageviews and visitors
Events
Sessions
Funnels, goals and retention
Websites, teams and users

Pricing checked on 23 Oct 2026 · Pricing page · Docs

Description

Umami is open-source web analytics. Its API exposes websites, stats, sessions, events, and reports such as funnels, goals and retention, plus admin areas for teams and users.

It fits agents and reports that need cookie-light traffic data. Use the cloud API with an API key, or run Umami yourself and use your own instance.

On Umami Cloud the API is not on the Hobby plan. You need Pro, or you self-host for free. Streaming API is Business only.

Key endpoints

  • GET /v1/websites: list your websites
  • GET /v1/websites/{websiteId}/stats: summary stats for a date range
  • GET /v1/websites/{websiteId}/events: events list
  • GET /v1/websites/{websiteId}/sessions: sessions list

Example request

curl https://api.umami.is/v1/websites \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Tech details

API style
REST
Base URL
https://api.umami.is
Rate limits
Cloud API key limited to 50 calls every 15 seconds.
Official SDKs
See docs

Use Cases

Pageviews and visitors

Funnels, goals and retention

Websites, teams and users

Editor’s note What our review found

Editorial research, reviewed 23 Oct 2026. We read Umami's pricing page and API docs. We did not run live calls. This listing is not an endorsement. An Umami MCP listing exists in this directory.

Cost: Hobby is $0 with 100K events and no API access. Pro is $20 a month with 1M events and API access. Business is $200 a month. Self-hosting is free, but you pay for your own server.

Credentials and data: cloud calls use an API key sent as a bearer token. Self-hosted instances need you to authenticate first (see the Authentication docs page). Store keys in a secret manager or environment variable, never in code or a plain-text file. Data returned is website analytics from your own sites.

Good to know: cloud API keys are limited to 50 calls per 15 seconds. The cloud base URL is api.umami.is/v1, while self-hosted uses your own domain with /api.

Related Skills, MCPs, CLIs & APIs

Frequently Asked Questions

Does Umami API have a free tier?
Free tier: Self-host only (free, open source).
How do I authenticate with Umami API?
Umami API uses an API key. Cloud API key sent as Authorization Bearer. Self-hosted instances use their own authentication flow.
What data does Umami API give?
Umami API provides: Pageviews and visitors, Events, Sessions, Funnels, goals and retention, Websites, teams and users.
How much does Umami API cost?
Pricing model: Paid. Pricing starts from $20/mo. Cloud API needs Pro at $20/mo. Hobby is free but has no API.