---
title: "Get Country Stats"
method: GET
path: "/website/{hostname}/countries"
tags: ["Stats"]
---

# Get Country Stats

`GET /website/{hostname}/countries`

Get a list of countries and their stats.

## Path parameters

- `hostname` string, hostname, required

## Query parameters

- `summary` boolean
- `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.
- `prop_name` 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.
- `prop_value` 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.
- `limit` integer
- `offset` integer

## Cookies

- `_me_sess` string, required

## Response `200`

OK

- object[]
  - `country` string, required — Country name.
  - `visitors` integer, required — Number of unique visitors from country.
  - `visitors_percentage` number, float, required — Percentage of unique visitors from country relative to all visitors.
  - `bounce_percentage` number, float — Bounce rate percentage from country.
  - `duration` integer — Total time spent on page from country in milliseconds.

## Other responses

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

---

[API](https://skmtc.net/medama-io/apis/medama-analytics-api.md) · [All operations](https://skmtc.net/medama-io/apis/medama-analytics-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/medama-io/medama-analytics-api/versions/77bbbf562f15/schema)