<!-- https://developers.silktide.com/v1/analytics/audience | Analytics -->

# Audience

Audience answers three questions about the people who visit: how many came and how they behaved (visitors, page views, bounce rate and time spent), where they came from (countries and regions), and what they used (browsers, operating systems and browser sizes).

Every query here takes the [Analytics arguments](https://developers.silktide.com/v1/analytics.md): `view` or `websiteId`, a `period`, and `filters`.

## Over time

The queries named "over time" answer with a series: one step per hour, day, week or month, oldest first, with every step present even when nothing was recorded in it. They need a period with a start, so send any `period` but `all`, the default: with `all` they answer with an error.

How long a step is depends on the period:

| Period | Each step |
| --- | --- |
| `today`, or `custom` with `from` and `to` the same day | An hour |
| `last-12-months`, or `custom` covering exactly twelve months | A month |
| Any other | A day |

With `period=custom`, `interval` chooses the step instead: `PT1H`, `P1D`, `P7D`, `P1M` or `P1Y`. Weeks start on Monday, so start a weekly range on a Monday: when `from` is another day, the visits before the first Monday are left out of the steps, though not out of `total`.

Send `previousPeriod=1` to compare: each step gains the figure from the same step of the period before, which is as long as yours and ends where yours starts.

## Visitors and page views

A visitor is one person, counted once however many pages they read. A visit (a session) is one stay on the website, from arriving to leaving. A page view is one page loaded.

Traffic collected at the Basic consent level records page views but no visitor and no visit. It counts in page views, and nowhere else: not in visitors, visits, bounce rate or time spent. A website that collects at Basic before visitors consent can show many page views and few visitors.

In Silktide itself: [Audience](https://docs.silktide.com/analytics/audience), in Help.
## Operations

- [Get how many people visited, step by step over a period](https://developers.silktide.com/v1/analytics/audience/get-visitors-over-time.md): `GET /v1/results/analytics/visitors`
- [Get how many pages were viewed, step by step over a period](https://developers.silktide.com/v1/analytics/audience/get-page-views-over-time.md): `GET /v1/results/analytics/page-views`
- [Get the share of visits that bounced, step by step over a period](https://developers.silktide.com/v1/analytics/audience/get-bounce-rate-over-time.md): `GET /v1/results/analytics/bounce-rate`
- [Get how long visits lasted, step by step over a period](https://developers.silktide.com/v1/analytics/audience/get-duration-over-time.md): `GET /v1/results/analytics/duration-over-time`
- [List the countries visitors came from](https://developers.silktide.com/v1/analytics/audience/get-countries.md): `GET /v1/results/analytics/countries`
- [List the regions within countries that visitors came from](https://developers.silktide.com/v1/analytics/audience/get-regions.md): `GET /v1/results/analytics/regions`
- [List the browsers visitors used](https://developers.silktide.com/v1/analytics/audience/get-browsers.md): `GET /v1/results/analytics/browsers`
- [List the operating systems visitors used](https://developers.silktide.com/v1/analytics/audience/get-operating-systems.md): `GET /v1/results/analytics/operating-systems`
- [List the sizes of browser window visitors used](https://developers.silktide.com/v1/analytics/audience/get-browser-sizes.md): `GET /v1/results/analytics/browser-sizes`
- [Get visitors at each browser size, step by step over a period](https://developers.silktide.com/v1/analytics/audience/get-browser-sizes-over-time.md): `GET /v1/results/analytics/browser-sizes-over-time`
