Umami logo

Umami

Umami is an open source, privacy-first web analytics platform that provides website traffic insights without cookies or personal data collection, serving as a simple and fast alternative to Google Analytics. The Umami API provides full programmatic access to analytics data, website management, session tracking, event data, and team collaboration features for both self-hosted and cloud instances.

1 APIs 8 Features
Cookieless TrackingOpen SourcePrivacyWeb AnalyticsWebsite Analytics

APIs

Umami API

The Umami API provides programmatic access to website analytics data including pageviews, sessions, events, and metrics, allowing developers to collect tracking data and retriev...

Features

Privacy-First Analytics

Tracks website traffic without cookies or personal data, fully GDPR compliant without consent banners.

Real-Time Data

Live visitor counts and real-time pageview tracking for immediate traffic insights.

Custom Events

Track custom user interactions and conversions with a simple JavaScript API.

Team Collaboration

Share analytics access across teams with role-based access control.

Self-Hosting Support

Deploy on your own infrastructure for complete data ownership and control.

Open Source

MIT-licensed open source software with active community development and full transparency.

Multi-Site Support

Manage and analyze multiple websites from a single Umami instance.

API Access

Full REST API for programmatic access to all analytics data and management functions.

Use Cases

Website Performance Monitoring

Track pageviews, unique visitors, bounce rates, and session duration for website optimization.

Privacy-Compliant Analytics

Replace Google Analytics with a cookieless solution that requires no consent banners under GDPR.

Marketing Analytics

Analyze traffic sources, referrers, and UTM campaign data to measure marketing effectiveness.

Custom Event Tracking

Track button clicks, form submissions, and custom conversions using the Umami event API.

Developer Dashboards

Build custom analytics dashboards using the REST API to display site metrics in your own apps.

Multi-Tenant Analytics

Provide analytics access to multiple clients or teams with shared infrastructure and access controls.

Integrations

Next.js

First-class integration with Next.js via the @umami/nextjs package for page view tracking.

WordPress

Track WordPress sites by adding the Umami tracking script via plugin or manual installation.

Vercel

Deploy Umami on Vercel with a one-click deployment for managed self-hosting.

Docker

Run Umami in any environment using the official Docker container image.

Cloudflare

Deploy tracking scripts behind Cloudflare for performance and abuse prevention.

Solutions

Umami Cloud

Hosted Umami instance at cloud.umami.is with managed infrastructure and API key authentication.

Umami Self-Hosted

Run your own Umami instance on any infrastructure with full data ownership and JWT authentication.

Semantic Vocabularies

Umami Context

0 classes · 0 properties

JSON-LD

API Governance Rules

Umami API Rules

31 rules · 13 errors 11 warnings 7 info

SPECTRAL

JSON Structure

Umami Active Visitors Structure

1 properties

JSON STRUCTURE

Umami Login Request Structure

2 properties

JSON STRUCTURE

Umami Login Response Structure

2 properties

JSON STRUCTURE

Umami Metric Structure

2 properties

JSON STRUCTURE

Umami Ok Response Structure

1 properties

JSON STRUCTURE

Umami Pageview Data Structure

2 properties

JSON STRUCTURE

Umami Session List Structure

4 properties

JSON STRUCTURE

Umami Session Stats Structure

5 properties

JSON STRUCTURE

Umami Session Structure

9 properties

JSON STRUCTURE

Umami Team List Structure

4 properties

JSON STRUCTURE

Umami Team Member Structure

6 properties

JSON STRUCTURE

Umami Team Request Structure

2 properties

JSON STRUCTURE

Umami Team Structure

8 properties

JSON STRUCTURE

Umami User Request Structure

3 properties

JSON STRUCTURE

Umami User Structure

6 properties

JSON STRUCTURE

Umami Website List Structure

4 properties

JSON STRUCTURE

Umami Website Request Structure

4 properties

JSON STRUCTURE

Umami Website Stats Structure

5 properties

JSON STRUCTURE

Umami Website Structure

10 properties

JSON STRUCTURE

Example Payloads

Umami Login Request Example

2 fields

EXAMPLE

Umami Login Response Example

2 fields

EXAMPLE

Umami Metric Example

2 fields

EXAMPLE

Umami Ok Response Example

1 fields

EXAMPLE

Umami Pageview Data Example

2 fields

EXAMPLE

Umami Session Example

9 fields

EXAMPLE

Umami Session List Example

4 fields

EXAMPLE

Umami Session Stats Example

5 fields

EXAMPLE

Umami Team Example

8 fields

EXAMPLE

Umami Team List Example

4 fields

EXAMPLE

Umami Team Member Example

6 fields

EXAMPLE

Umami Team Request Example

2 fields

EXAMPLE

Umami User Example

6 fields

EXAMPLE

Umami User Request Example

3 fields

EXAMPLE

Umami Website Example

10 fields

EXAMPLE

Umami Website List Example

4 fields

EXAMPLE

Umami Website Stats Example

5 fields

EXAMPLE

Resources

🔗
LinkedIn
LinkedIn
🔗
Website
Website
🔗
Documentation
Documentation
📰
Blog
Blog
💰
Pricing
Pricing
👥
GitHub
GitHub
🔗
Login
Login
📝
SignUp
SignUp
🔗
SelfHosting
SelfHosting
💬
Support
Support
🔗
SpectralRules
SpectralRules
🔗
Vocabulary
Vocabulary

Sources

Raw ↑
aid: umami
name: Umami
description: >-
  Umami is an open source, privacy-first web analytics platform that provides website traffic insights without cookies
  or personal data collection, serving as a simple and fast alternative to Google Analytics. The Umami API provides full
  programmatic access to analytics data, website management, session tracking, event data, and team collaboration
  features for both self-hosted and cloud instances.
type: Index
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
  - Cookieless Tracking
  - Open Source
  - Privacy
  - Web Analytics
  - Website Analytics
url: https://raw.githubusercontent.com/api-evangelist/umami/refs/heads/main/apis.yml
created: '2026-03-26'
modified: '2026-05-19'
specificationVersion: '0.19'
apis:
  - aid: umami:umami-api
    name: Umami API
    description: >-
      The Umami API provides programmatic access to website analytics data including pageviews, sessions, events, and
      metrics, allowing developers to collect tracking data and retrieve analytics reports. Self-hosted instances use
      JWT bearer tokens; Umami Cloud uses API key authentication.
    humanURL: https://umami.is
    baseURL: https://api.umami.is
    tags:
      - Open Source
      - Privacy
      - Tracking API
      - Web Analytics
    properties:
      - type: Documentation
        url: https://umami.is/docs
      - type: GettingStarted
        url: https://umami.is/docs/getting-started
      - type: APIDocumentation
        url: https://umami.is/docs/api
      - type: GitHubOrg
        url: https://github.com/umami-software/umami
      - type: OpenAPI
        url: openapi/umami-openapi.yml
      - type: JSONSchema
        url: json-schema/umami-website-schema.json
      - type: JSONSchema
        url: json-schema/umami-website-list-schema.json
      - type: JSONSchema
        url: json-schema/umami-website-request-schema.json
      - type: JSONSchema
        url: json-schema/umami-website-stats-schema.json
      - type: JSONSchema
        url: json-schema/umami-pageview-data-schema.json
      - type: JSONSchema
        url: json-schema/umami-metric-schema.json
      - type: JSONSchema
        url: json-schema/umami-active-visitors-schema.json
      - type: JSONSchema
        url: json-schema/umami-session-schema.json
      - type: JSONSchema
        url: json-schema/umami-session-list-schema.json
      - type: JSONSchema
        url: json-schema/umami-session-stats-schema.json
      - type: JSONSchema
        url: json-schema/umami-user-schema.json
      - type: JSONSchema
        url: json-schema/umami-user-request-schema.json
      - type: JSONSchema
        url: json-schema/umami-team-schema.json
      - type: JSONSchema
        url: json-schema/umami-team-list-schema.json
      - type: JSONSchema
        url: json-schema/umami-team-member-schema.json
      - type: JSONSchema
        url: json-schema/umami-team-request-schema.json
      - type: JSONSchema
        url: json-schema/umami-login-request-schema.json
      - type: JSONSchema
        url: json-schema/umami-login-response-schema.json
      - type: JSONSchema
        url: json-schema/umami-ok-response-schema.json
      - type: JSONStructure
        url: json-structure/umami-website-structure.json
      - type: JSONStructure
        url: json-structure/umami-website-list-structure.json
      - type: JSONStructure
        url: json-structure/umami-website-stats-structure.json
      - type: JSONStructure
        url: json-structure/umami-session-structure.json
      - type: JSONStructure
        url: json-structure/umami-session-list-structure.json
      - type: JSONStructure
        url: json-structure/umami-metric-structure.json
      - type: JSONStructure
        url: json-structure/umami-user-structure.json
      - type: JSONStructure
        url: json-structure/umami-team-structure.json
      - type: JSONStructure
        url: json-structure/umami-team-member-structure.json
      - type: JSONLDContext
        url: json-ld/umami-context.jsonld
      - type: Example
        url: examples/umami-website-example.json
      - type: Example
        url: examples/umami-website-stats-example.json
      - type: Example
        url: examples/umami-pageview-data-example.json
      - type: Example
        url: examples/umami-metric-example.json
      - type: Example
        url: examples/umami-session-example.json
      - type: Example
        url: examples/umami-session-stats-example.json
      - type: Example
        url: examples/umami-user-example.json
      - type: Example
        url: examples/umami-team-example.json
      - type: Example
        url: examples/umami-active-visitors-example.json
common:
  - type: LinkedIn
    url: https://www.linkedin.com/company/umami-software
  - type: Website
    url: https://umami.is
  - type: Documentation
    url: https://umami.is/docs
  - type: Blog
    url: https://umami.is/blog
  - type: Pricing
    url: https://umami.is/pricing
  - type: GitHub
    url: https://github.com/umami-software/umami
  - type: Login
    url: https://cloud.umami.is
  - type: SignUp
    url: https://cloud.umami.is
  - type: SelfHosting
    url: https://umami.is/docs/install
  - type: Support
    url: https://umami.is/docs/support
  - type: SpectralRules
    url: rules/umami-spectral-rules.yml
  - type: Vocabulary
    url: vocabulary/umami-vocabulary.yaml
  - type: Features
    data:
      - name: Privacy-First Analytics
        description: Tracks website traffic without cookies or personal data, fully GDPR compliant without consent banners.
      - name: Real-Time Data
        description: Live visitor counts and real-time pageview tracking for immediate traffic insights.
      - name: Custom Events
        description: Track custom user interactions and conversions with a simple JavaScript API.
      - name: Team Collaboration
        description: Share analytics access across teams with role-based access control.
      - name: Self-Hosting Support
        description: Deploy on your own infrastructure for complete data ownership and control.
      - name: Open Source
        description: MIT-licensed open source software with active community development and full transparency.
      - name: Multi-Site Support
        description: Manage and analyze multiple websites from a single Umami instance.
      - name: API Access
        description: Full REST API for programmatic access to all analytics data and management functions.
  - type: UseCases
    data:
      - name: Website Performance Monitoring
        description: Track pageviews, unique visitors, bounce rates, and session duration for website optimization.
      - name: Privacy-Compliant Analytics
        description: Replace Google Analytics with a cookieless solution that requires no consent banners under GDPR.
      - name: Marketing Analytics
        description: Analyze traffic sources, referrers, and UTM campaign data to measure marketing effectiveness.
      - name: Custom Event Tracking
        description: Track button clicks, form submissions, and custom conversions using the Umami event API.
      - name: Developer Dashboards
        description: Build custom analytics dashboards using the REST API to display site metrics in your own apps.
      - name: Multi-Tenant Analytics
        description: Provide analytics access to multiple clients or teams with shared infrastructure and access controls.
  - type: Integrations
    data:
      - name: Next.js
        description: First-class integration with Next.js via the @umami/nextjs package for page view tracking.
      - name: WordPress
        description: Track WordPress sites by adding the Umami tracking script via plugin or manual installation.
      - name: Vercel
        description: Deploy Umami on Vercel with a one-click deployment for managed self-hosting.
      - name: Docker
        description: Run Umami in any environment using the official Docker container image.
      - name: Cloudflare
        description: Deploy tracking scripts behind Cloudflare for performance and abuse prevention.
  - type: Solutions
    data:
      - name: Umami Cloud
        description: Hosted Umami instance at cloud.umami.is with managed infrastructure and API key authentication.
      - name: Umami Self-Hosted
        description: Run your own Umami instance on any infrastructure with full data ownership and JWT authentication.
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com