---
title: "Get Stat Summary"
method: GET
path: "/website/{hostname}/summary"
tags: ["Stats"]
---

# Get Stat Summary

`GET /website/{hostname}/summary`

Get a summary of the website's stats.

## Path parameters

- `hostname` string, hostname, required

## Query parameters

- `previous` boolean
- `interval` 'minute' | 'hour' | 'day' | 'week' | 'month'
- `start` string, date-time
- `end` string, date-time
- `path` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `referrer` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `utm_source` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `utm_medium` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `utm_campaign` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `browser` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `os` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `device` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `country` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.
- `language` FilterString
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `contains` string — Contains.
  - `not_contains` string — Does not contain.
  - `starts_with` string — Starts with.
  - `not_starts_with` string — Does not start with.
  - `ends_with` string — Ends with.
  - `not_ends_with` string — Does not end with.
  - `in` string — In.
  - `not_in` string — Not in.

## Cookies

- `_me_sess` string, required

## Response `200`

OK

- StatsSummary
  - `current` object, required
    - `visitors` integer, required
    - `pageviews` integer, required
    - `bounces` integer, required
    - `duration` integer, required
  - `previous` object
    - `visitors` integer, required
    - `pageviews` integer, required
    - `bounces` integer, required
    - `duration` integer, required
  - `interval` object[]
    - `date` string, required
    - `visitors` integer
    - `pageviews` integer
    - `bounces` integer
    - `duration` integer

## Other responses

- `400` — 400 Bad Request.
- `401` — 401 Unauthorised.
- `404` — 404 Not Found.
- `500` — 500 Unexpected Internal Server Error.

## Changes

- **2024-06-30** `860d419093ef` — 2 info
  - api tag `Stats` added
  - api tag `stats` removed
- **2024-06-26** `70561548e0ed` — 1 breaking, 2 info
  - the response property `interval/items/visitors` became optional for the status `200`
  - added the optional property `interval/items/bounces` to the response with the `200` status
  - added the optional property `interval/items/duration` to the response with the `200` status
- **2024-02-25** `89302591c001` — 1 breaking, 2 info
  - removed the enum value `year` from the `query` request parameter `interval`
  - added the new enum value `minute` to the `query` request parameter `interval`
  - added the optional property `interval` to the response with the `200` status
- **2024-02-16** `7faed8d7ec93` — 2 info
  - for the `query` request parameter `end`, the format was generalized from `date` to `date-time`
  - for the `query` request parameter `start`, the format was generalized from `date` to `date-time`
- **2024-02-15** `919688221e87` — 1 breaking
  - removed the required property `current/active` from the response with the `200` status

[Full history](https://skmtc.dev/medama-io/apis/medama-analytics-api/changes/website/:hostname/summary/get.md)

---

[API](https://skmtc.dev/medama-io/apis/medama-analytics-api.md) · [All operations](https://skmtc.dev/medama-io/apis/medama-analytics-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medama-io/apis/medama-analytics-api/revisions/3eb6ca7aea57?raw)