---
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
- `start` string, date-time
- `end` string, date-time
- `interval` 'hour' | 'day' | 'week' | 'month' | 'year'
- `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` FilterFixed
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `in` string — In.
  - `not_in` string — Not in.
- `os` FilterFixed
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `in` string — In.
  - `not_in` string — Not in.
- `device` FilterFixed
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `in` string — In.
  - `not_in` string — Not in.
- `country` FilterFixed
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `in` string — In.
  - `not_in` string — Not in.
- `language` FilterFixed
  - `eq` string — Equal to.
  - `neq` string — Not equal to.
  - `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

## Other responses

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

## Changes

- **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
- **2024-01-30** `b3fcc629d098` — 2 breaking, 2 info
  - removed the required property `current/uniques` from the response with the `200` status
  - removed the required property `previous/uniques` from the response with the `200` status
  - added the required property `current/visitors` to the response with the `200` status
  - added the required property `previous/visitors` to the response with the `200` status
- **2024-01-30** `eefc6adaa33a` — 2 warning, 1 info
  - deleted the `query` request parameter `referrer_host`
  - deleted the `query` request parameter `referrer_path`
  - added the new optional `query` request parameter `referrer`
- **2024-01-22** `6551306b6ea8` — 1 warning
  - deleted the `query` request parameter `browser_version`

[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-service-production.skmtc.workers.dev/v1/apis/medama-io/medama-analytics-api/revisions/7e58a00a419e/schema)