---
title: "Get analytics overview"
method: GET
path: "/analytics/overview"
tags: ["Analytics"]
---

# Get analytics overview

`GET /analytics/overview`

## Request

- Base URL: `https://api.cavuno.com/v1`
- URL: `https://api.cavuno.com/v1/analytics/overview`
- Auth: HTTP bearer

Typed Board homepage analytics overview for the authenticated Board: sessions, page views, average session duration, apply clicks, and conditional impressions/revenue metrics. Omits unavailable conditional metrics rather than returning provider connection state. Inclusive UTC date-only range; defaults to the last 30 completed UTC days ending yesterday. Max range 366 days.

## Query parameters

- `start` string: Inclusive range start (UTC date-only YYYY-MM-DD).
- `end` string: Inclusive range end (UTC date-only YYYY-MM-DD).

## Response `200`

Analytics overview for the requested range.

- AnalyticsOverview
  - `object` 'analytics_overview', required
  - `range` AnalyticsDateRange, required
    - `start` string, required: UTC date-only YYYY-MM-DD.
    - `end` string, required: UTC date-only YYYY-MM-DD.
  - `comparisonRange` AnalyticsDateRange, required
    - `start` string, required: UTC date-only YYYY-MM-DD.
    - `end` string, required: UTC date-only YYYY-MM-DD.
  - `currentVisitors` integer, required: Realtime visitors on the board right now.
  - `metrics` AnalyticsMetric[], required
    - `key` 'sessions' | 'page_views' | 'average_session_duration' | 'job_apply_clicks' | 'impressions' | 'stripe_revenue' | 'adsense_revenue', required
    - `unit` 'count' | 'seconds' | 'currency', required
    - `currency` string: ISO currency code in lowercase when unit is currency.
    - `current` object, required
      - `total` number, required
      - `change` AnalyticsChange, required
        - `absolute` number, required
        - `percentage` number, nullable, required: Null when both periods are zero (undefined percent change).
      - `points` AnalyticsTrendPoint[], required
        - `date` string, required: UTC date-only YYYY-MM-DD.
        - `value` number, nullable, required: Metric value for the day, or null when a lagging provider has not reported yet.
    - `previous` object, required
      - `total` number, required
      - `points` AnalyticsTrendPoint[], required
        - `date` string, required: UTC date-only YYYY-MM-DD.
        - `value` number, nullable, required: Metric value for the day, or null when a lagging provider has not reported yet.
    - `dataAvailableThrough` string: Latest available day for lagging providers (GSC/AdSense) when the window tail is incomplete.

## Other responses

- `default`: An error. Every non-2xx response uses the same envelope; see the Errors section of the introduction.

## Changes

- **2026-10-19** `c34152c38176`: 1 info
  - added the optional property `error/upgrade` to the response with the `default` status

[Operation history](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/changes/analytics/overview/get.md)

---

[API](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api.md) · [All operations](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/revisions/d5974dabff14?raw)